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PREFACE 



This manua! describes the CP-V features that are designed to aid the system programmer in the development, 
maintenance, and modification jr the CP-V system. 

Manuals describing other features of CP-V are outlined below: 

• The CP-V System Management Reference Manual, 90 16 74, is the principal source of reference informa- 
tion for the system management features of CP-V. It defines the rules for generating a CP-V system 
(SYSGEN), authorizing users, maintaining user accounting records, maintaining the file system, monitor- 
ing system performance, and other related functions. 

• The CP-V Batch Reference Manual, 90 17 64, is the principal source of reference information for the batch 
processing features of CP-V (i.e., job control commands, system procedures, I/O procedures, program 
loading and execution, debugging aids, and service processors). 

• The CP-V Time-Sharing Reference Manual, 90 09 07, is the principal source of information for the time- 
sharing features of C P-V. It defines the rules for using the Terminal Executive Language and other 
terminal processors. 

• The CP-V Time-Sharing User's Guide, 90 16 92, describes how to use the various time-sharing features. 
It presents an introductory subset of the features in a format that allows the user to learn the material by 
using the features at a terminal as he reads through the document. 

• The CP-V Remote Processing Reference Manual, 90 30 26, is the principal source of information about the 
remote processing features of CP-V. All information about remote processing for all computer personnel 
(remote and local users, system managers, remote site operators, and central site operators) is included in 
the manual. 

• The CP-V Transaction Processing Reference Manual, 90 31 12, provides information about dynamically 
modifying andqueryinga central database in a transaction processing environment. The manual is addressed 
to system managers, database administrators, applications programmers, and computer operators. 

• The CP-V Operations Reference Manual, 90 16 75, is the principal source of reference information for 
CP-V computer operators. It defines the rules for operator communication (i.e., key-ins and messages), 
system start-up and initialization, job and system control, peripheral device handling, recovery and file 
preservation. 

• The CP-V Common Index (90 30 80) is an index to all of the above CP-V manuals. 

Information for the language and application processors that operate under CP-V is also described in separate man- 
uals. These manuals are listed on the Related Publications page of this manual. 



COMMAND SYNTAX NOTATION 



Notation conventions used in command specifications and examples throughout this manual are listed below. 



Notation 



Description 



lowercase letters 



CAPITAL LETTERS 



[] 



U 



Numbers and 
special characters 



Subscripts 



Superscripts 



Underscore 



©@© 



Lowercase letters identify an element that must be replaced with a 
user-selected value. 

CRndd could be entered as CRA03. 

Capital letters must be entered as shown for input, and will be printed as 
shown in output. 

DPndd means "enter DP followed by the values for ndd". 

An element inside brackets is optional. Several elements placed one under 
the other inside a pair of brackets means that the user may select any one or 
none of those elements. 

[KEYM] means the term "KEYM" may be entered. 

Elements placed one under the other inside a pair of braces identify a re- 
quired choice. 



{£} 



means that either the letter A or the value of id must be entered. 



The horizontal ellipsis indicates that a previous bracketed element may be 
repeated, or that elements have been omitted. 

name[, name"]. . . means that one or more name values may be 

entered, with a comma inserted between each name value. 

The vertical ellipsis indicates that commands or instructions have been 
omitted. 



MASK2 DATA, 2 X'lEF' 
BYTE DATA, 3 BA(L(59)) 



means that there are one or more state- 
ments omitted between the two DATA 
directives. 



Numbers that appear on the line (i.e. , not subscripts), special symbols, and 
punctuation marks other than dotted lines, brackets, braces, and underlines 
appear as shown in output messages and must be entered as shown when input. 

(value) means that the proper value must be entered enclosed in 

parentheses; e.g., (234). 

Subscripts indicate a first, second, etc. , representation of a parameter that 
has a different value for each occurrence. 

sysidi,sysid2/Sysid3 means that three successive values for sysid 
should be entered, separated by commas. 

Superscripts indicate shift keys to be used in combination with terminal keys, 
c is control shift, and s is case shift. 

L cs means press the control and case shift (CONTROL and SHIFT) and 
the L key. 

All terminal output is underscored; terminal input is not. 

•RUN means that the exclamation point was sent to the terminal, but 
RUN was typed by the terminal user. 

These symbols indicate that an ESC (©), carriage return (©), or line feed 
(©) character has been sent. 

IEDIT ©means that, after typing EDIT, a carriage return character 
has been sent. 



GLOSSARY 



ANS tape a tape that has labels written in American 

National Standard (ANS) format. 

batch job a job that is submitted to the batch job stream 

through the central site card reader, through an on-line 
terminal (using the Batch processor), or through a re- 
mote terminal. 

binary input input from the device to which the BI 

(binary input) operational label is assigned. 

concatenation a process whereby a number of files with 

the same filename and format are treated as one logical 
file. Concatenation is only applicable to ANS tapes. 

conflicting reference a reference to a symbolic name 

that has more than one definition. 

control command any control message other than a key-in. 
A control command may be input via any device 
to which the system command input function has been 
assigned (normally a card reader). 

control message any message received by the monitor 
that is either a control command or a control key-in. 

cooperative a monitor routine that transfers information 

between a user's program and disk storage (also see 
"symbiont"). 

data control block (DCB) a table in the user's program 
that contains the information used by the monitor in 
the performance of an I/O operation. 

external reference a reference to a declared symbolic 
name that is not defined within the object module in 
which the reference occurs. An external reference 
can be satisfied only if the referenced name is de- 
fined by an external load item in another object 
module. 

file extension a convention that is used when certain 
system output DCBs are opened. Use of this conven- 
tion causes the file (on RAD, tape, disk pack, etc.) 
connected to the DCB to be positioned to a point just 
following the last record in the file. When additional 
output is produced through the DCB, it is added to the 
previous contents of the file, thereby extending the 
file. 

function parameter table (FPT) a table through which a 
user's program communicates with a monitor function 
(such as an I/O function). 

ghost job a job that is neither a batch nor an on-line 

program. It is initiated and logged on by the monitor, 
the operator, or another job and consists of a single 
job step. When the ghost program exits, the ghost is 
logged off. 



global symbol a symbolic name that is defined in one 

program module and referenced in another. 

GO file a temporary disk storage file consisting of re- 

locatable object modules formed by a processor. 

granule a block of disk sectors large enough to contain 

512 words (a page) of stored information. 

job information table (JIT) a table associated with each 

active job. The table contains accounting, memory 
mapping, swapping, terminal DCB(M:UC), and tempo- 
rary monitor information. 

job step a subunit of job processing such as compilation, 

assembly, loading, or execution. Information from cer- 
tain commands (JOB, LIMIT, and ASSIGN) and all 
temporary files created during a job step are carried 
from one job step to the next but the steps are otherwise 
independent. 

key a data item consisting of 1-31 alphanumeric char- 
acters that uniquely identifies a record. 

key-in information entered by the operator via a 

keyboard. 

language processor a program that translates a user's 
source language program into an object language 
program. 

library load module a load module that maybe combined 

with relocatable object modules, or other library load 
modules, to form a new executable load module. 

linking loader a program that is capable of linking and 
loading one or more relocatable object modules and 
load modules. 

load map a listing of loader output showing the location 

or value of all global symbols entering into the load. 
Also shown are symbols that are not defined or have 
multiple definitions. 

load module (LM) an executable program formed by the 

linking loader, using relocatable object modules 
(ROMs) and/or modules (LMs) as input information. 

logical device a peripheral device that is represented 

in a program by an operational label (e.g., BI or PO) 
rather than by specific physical device name. 

logical device stream an information stream that may 

be used when performing input from or output to a sym- 
biont device. At SYSGEN, up to 15 logical device 
streams are defined. Each logical device stream is 
given a name (e.g., LI, PI, CI), each is assigned to 
a default physical device, and each is given default 
attributes. The user may perform I/O through a logical 



device stream with the default physical device and 
attributes or he maychange the physical device and/or 
attributes to satisfy the requirements of his job. 

monitor a program that supervises the processing, load- 

ing, and execution of other programs. 

object language the standard binary language in which 

the output of a language processor is expressed. 

object module the series of records containing the load in- 

formation pertaining to a singleprogram or subprogram 
(i.e., from the beginning to the end). Object modules 
serve as input to the Load processor or Link processor. 

on-line job a job that is submitted through an on-line 

terminal by a command other than the BATCH command. 

operational label a symbolic name used to identify a 

logical system device. 

overlay loader a monitor routine that loads and links 

elements of overlay programs. 

overlay program a segmented program in which the ele- 

ment (i.e., segment) currently being executed may 
overlay the core storage area occupied by a previously 
executed element. 

patch a symbolic representation of a correction to the 

system that is used to temporarily correct the system 
without necessitating a reassembly. 

physical device a peripheral device that is referred to 

by a name specifying the device type, I/O channel, 
and device number (also see "logical device"). 

program product a compiler or application program that 

has been or will be released by Xerox, but is not re- 
quired by all users and is therefore made available by 
Xerox on an optional basis. Program products are pro- 
vided only to those users who execute a License Agree- 
ment for each applicable installation. 

prompt character a character that is sent to the terminal 

by an on-line processor to indicate that the next line 
of input may be entered. 

protective mode a mode of tape protection in which only 

ANS expired tapes may be written on through an ANS 
DCB; no unexpired ANS tape maybe written on through 
a non-ANS DCB; all ANS tapes must be initialized by 
the Label processor; no tape serial number specification 
is allowed at the operator's console; specification of an 
output serial number in an ANS DCB forces processing 
to be done only on a tape already having that serial 
number; tapes mounted as IN may not be written; and 
tapes mounted as other than IN must have a write ring. 
(See "semiprotective mode".) 

public library a set of library routines declared at 

SYSGEN to be public (i.e., to be used in common by 
all concurrent users). 



reentrant an attribute of a program that allows the 

program to be shared by several users concurrently. 
Shared processors in CP-Vare reentrant. That is, each 
instance of execution of the single copy of the pro- 
gram's instructions has a separately mapped copy of the 
execution data. 

relative allocation allocation of virtual memory to a 

user program starting with the first unallocated page 
available. 

relocatable object module (ROM) a program or subpro- 

gram in object language generated by a processor such 
as Meta-Symbol or FORTRAN. 

remote processing an extension of the symbiont system 

that provides flexible communication between CP-V 
and a variety of remote terminals. 

resident program a program that has been loaded info a 

dedicated area of core memory. 

response time the time between the completion of termi- 

nal input and the first program activation. 

scheduler a monitor routine that controls the initiation 
and termination of all jobs, job steps, and time slice 
quanta. 

secondary storage any rapid-access storage medium other 

than core memory (e.g., RAD storage). 

semi -protective mode a mode of tape protection in which 

a warning is posted to the operator when an ANS DCB 
attempts output on a non-ANS tape or an unexpired ANS 
tape, when a non-ANS DCB attempts output on an un- 
expired ANS tape, or when a tape mounted as IN OUT 
has no write ring. The operator can authorize the over- 
writing of the tape or the override of INOUT through a 
key-in (OVER and READ). ANS tapes may be ini- 
tialized by the Label processor or may be given labels 
as the result of an operator key-in; tape serial number 
specification is allowed at the operator's console; and 
specification of an output serial number in an ANS 
DCB forces processing to be done only on a tape al- 
ready having that serial number unless the operator 
authorizes an overwrite. (See "protective mode". ) 

shared processor a program (e.g., FORTRAN) that is 

shared by all concurrent users. Shared processors must 
be established during SYSGEN or via DRSP. 

source language a language used to prepare a source 
program suitable for processing by an assembler or 
compiler. 

special shared processor a shared processor that may be 

in core memory concurrently with the user's program 
(e.g., Delta, TEL, or the FORTRAN library). 

specific allocation allocation of a specific page of 

unallocated virtual memory to a user program. 



SRI, SR2, SR3, and SR4 see "system register", below. 

static core module a program module that is in core 
memory but is not being executed. 

stream-id the name of a logical device stream. 

symbiont a monitor routine that transfers information 

between disk storage and a peripheral device inde- 
pendent of and concurrent with job processing. 

symbolic input input from the device to which the SI 

(symbolic input) operational label is assigned. 

symbolic name an identifier that is associated with 
some particular source program statement or item so 
that symbolic references maybe made to it even though 
its value may be subject to redefinition. 

SYSGEN see "system generation", below. 

system generation (SYSGEN) the process of creating an 
operating system that is tailored to the specific require- 
ments of an installation. The major SYSGEN steps 



include: gathering the relevant programs, generating 
specific monitor tables, loading monitor and system 
processors, and writing a bootable system tape. 

system library a group of standard routines in object- 
language format, any of which may be incorporated in 
a program being formed. 

system register a register used by the monitor to commu- 
nicate information that may be of use to the user pro- 
gram (e.g., error codes). System registers SRI, SR2, 
SR3, and SR4 are current general registers 8, 9, 10, 
and 11, respectively. 

task control block (TCB) a table of program control in- 
formation built by the loader when a load module is 
formed. The TCB is part of the load module and con- 
tains the data required to allow reentry of library rou- 
tines during program execution or to allow entry to the 
program in cases of traps, breaks, etc. The TCB is 
program associated and not task associated. 

unsatisfied reference a symbolic name that has been ref- 
erenced but not defined. 



1. INTRODUCTION 



CP-V SERVICES 

Control Program-Five (CP-V) is a comprehensive operating 
system designed for use with Sigma 6/7/9 and Xerox 560 
computers and a variety of peripheral equipment. CP-V 
offers: 

• On-line time-sharing, batch processing, remote pro- 
cessing, transaction processing, and real-time services. 



Ability to handle a large number of concurrent users. 



High efficiency due to hardware relocation map, 
shared reentrant processors, multiple I/O processors, 
and device pooling. 



• A complete recovery system coupled with preservation 
of user files to provide fast restart following hardware 
or software malfunction. 



• For on-line users: highly efficient and extensive soft- 
ware, file saving feature, fast response time. 



For batch users: on-line, local, and remote entry to 
an efficient multiprogramming batch job scheduler. 



For installation managers: thorough system monitoring 
and reporting, control and tuning ability, extensive 
error checking and recovery features. 



For all users: comprehensive accounting and a com- 
plete set of powerful processors. 



TIMESHARING AND BATCH PROCESSING 

CP-V allows multiple on-line terminal users to concurrently 
create, debug, and execute programs. Concurrent to time- 
sharing, CP-V allows up to 16 batch processing jobs to 
execute in its multiprogramming environment. An efficient 
multi-batch scheduler selects batch jobs for execution 
according to priority, job requirements, and availability of 
resources. Batch jobs may be submitted to this scheduler 
from a local batch entry device such as a card reader, from 
an on-line user's terminal, or from a remote site such as a 
remote batch terminal or another computer. 

Time-sharing and batch users have access to a variety 
of powerful and comprehensive language processors and 
facilities. These processors and facilities are listed 
below. 



Processor 
TEL 

EASY 
Edit 

FORTRAN IV 

COBOL 
Meta-Symbol 

BASIC 

A PL 
FLAG 
FDP 
Delta 



COBOL On-line 
Debugger 

PCL 



Link 

LYNX 

Load 

Batch 

Manage 
5L-1 

CIRC 



Function 

Executive language control of all 
terminal activities. (On-line only. ) 

Creation, manipulation, and execution 
of FORTRAN and BASIC programs and 
data files. (On-line only.) 

Composition and modification of pro- 
grams and other bodies of text. (On- 
line only. ) 

Compilation of Extended FORTRAN IV 
programs. 

Compilation of ANS COBOL programs. 

Assembly of high-level assembly lan- 
guage programs. 

Compilation and execution of programs 
or direct statements written in an ex- 
tended BASIC language. 

Interpretation and execution of pro- 
grams written in the APL language. 

Compilation of fast "load-and-go" 
FORTRAN programs. 

Debugging of Extended FORTRAN IV 
programs. 

Debugging of programs at the assembly 
language level. (On-line only. ) 

Debugging of ANS COBOL programs. 
(On-line only. ) 

Transfer (and conversion) of data be- 
tween peripheral devices. 

Linkage of programs for execution. 

Linkage of programs for execution. 

Linkage of programs for execution 
(Batch only. ) 

Submission of batch jobs via an on- 
line terminal or another batch job. 

File retrieval, updating, and reporting. 

Compilation of programs written in a 
language designed specifically for 
digital or hybrid simulation. 

Analysis of electronic circuits. 
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Pr ocess or Function 

EDMS Organization, storing, updating, and 

deletion of information in a centralized 
data base. 

Sort Merge Sorting and/ or merging of records in 

one or more files. 

GPDS Experimentation with and evaluation of 

iystem methods, processes, and designs. 
(Batch oniy . ) 

REMOTE PROCESSING 

The remote processing '../stem is an extension of the CP-V 
symbionf system. Its purpose is to provide for flexible com- 
munication between CP-Vand u variety of remote terminals. 
These terminals can range from a simple card reader, card 
punch, and line printer combination to another computer 
system with a wide variety of peripheral devices. Any CP-V 
user (batch, on-line,, ghost) can communicate with any 
number of devices at one or several remote sites. Because 
CP-V can act as a central site to some remote sites and 
simultaneously as a remote terminal to other computers, 
the remote processing facilities encourage the construction 
of communication networks. 



TRANSACTION PROCESSING 

The transaction processing feature of CP-V is an efficient 
and economical approach to centralized information pro- 
cessing and is a generalized package that is designed to 
meet the requirements of a variety of business applications. 
Transaction processing facilities provide an environment in 
which several users at remote terminals may enter business 
transactions, simultaneously utilizing a common data base. 
The transactions are processed immediately, as they are 
received, by application programs written especially for 
the particular installation. As necessary, reports may 
then be created and sent to an appropriate terminal. 



REAL TIME PROCESSING 

The real-time services provided by CP-V allow users to 
connect interrupts to mapped programs, control the state of 
interrupts (e.g., trigger, arm/disarm, enable/disable), 
clear interrupts either at the time of occurrence or upon 
completion of processing, and disconnect interrupts no 



longer required. Users may also request that a mapped 
program be held in core in order to reduce the time required 
to respond to an external event (via an interrupt) or to 
allow various forms of special I/O to occur. Programs may 
be connected to one of the monitor's clocks such that after 
a specified period of time, a specified routine is entered. 
In addition, dedicated foreground memory moy be used as 
inter-program communication buffers or as dedicated memory 
for unmapped, master mode programs wh^h may be directly 
connected to external interrupts or real-rime clocks. 



SYSTEM PROGRAMMING FACILITIES 

fhis manual describes the CP-V features rhat are designed 
to aid the system programmer in the development, main- 
tenance, and modification of the CP-V system. The facil- 
ities described in this manual aid the system programmer 
in the following areas; 

• Modification of the CP-V operating system at the 
instruction level at boot-time. 

• Reconfiguration of peripheral devices at boor-time. 

• Analysis of crash dumps to determine the cause of a 
system crash. 

• Creation and modification of the e-.-ror message file 
for the CP-V monitor overlays while the system is 
operational. 

• Listing and analysis of hardware and software mal- 
functions occurring during system operation. 

• Development of shared processors such as compilers, 
assemblers, command language processors, and 
debuggers. 

• Replacement, creation, and deletion of shared pro- 
cessors and monitor overlays while the system is 
operational. 

• Development of peripheral hardware diagnostic 
programs. 

• Development of real-time programs. 

• Support of transaction processing facilities. 

• Implementation of remotediagnostics for the Xerox 560. 



System Programming Facilities 



2. SYSTEM OVERVIEW 
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COMMAND PROCESSORS 



The CP-V operating system consists of a monitor and a 
number of associated processors (Figure 1). The monitor 
provides overall supervision of program processing. The 
associated processors provide specific functions such as 
compilation, execution,, and debugging. 



The four processors in this group are: LOGON/LOGOFF, 
EASY, TEL, and CCI. The first of these processors is avail- 
able to on-line and batch users, the second and third are 
available to on-line users only, and the last is available to 
batch users only. 



PROCESSORS 

The CP-V system is Illustrated In Figure 1 at two levels. The 
upper level lists the various monitor routines. The lower 
level lists the various processors. The processors are de- 
scribed in the following paragraphs. 



LOGON/LOGOFF 

LOGON admits on-line users to the system and connects 
the user's terminal either to TEL or to an alternative pro- 
cessor, such as BASIC, that has been selected by the user. 
LOGOFF disconnects a user from the system and does the 
final cleanup and accounting. 
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Figure 1. CP-V Operating System 
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EASY 

EASY is a shared processor that enables the user fo create, 
edit, execute, save, and delete program files written in 
BASIC or FORTRAN. EASY also allows the user to create 
and manipulate EBCDIC! data files. Although intended pri- 
marily for Teletype® operations, EASY can be used with 
any type of on-line terminal supported by the system. 
(Refe.ence: EASY/LN,OPS Reference Manual, 90 18 73.) 



UK/vWNAI EXECUTIVE LANGUAGE 

TEL is iht? default command processor for time-sharing and 
serves as tliu Terminal user's interface to the various services 
of CP-V. EEL is functionally equivalent to the batch mode 
Control Command Interpreter. Some of the functions per- 
formed by TEL are: 

1. Coiling user programs and system processors. 

2. Changing tin. iog-on pus:-..' . >rd. 

3. Aligning 1/ O j::v i <• c. an i VC 3 parameters. 

4. Requesting t.-xiendeu memory mode. 

5. Determining on-line user sterns. 
o. Changing terminal platen size. 

Sending messages to the operator. 
S. Logging off. 

CONTROL COMMAND INTERPRETER 

ihe Control Command Interpreter is the batch counterpart 
of TEL. If provides the batch user with control over the 
processing of batch programs fust as TEL provides on-line 
users with control over the processing of on-line programs. 
(Reference: CP-V/BP Reference Manual, 90 17 64. ) 



individually authorize ordeny access fo the various processors 
for each user. Super is also used to create and delete remote 
processing workstations. (Reference: Ci'-V/SM Reference 
Manual, 90 16 74. ) 



CONTROL 

The Control processor provides control over system perfor- 
mance. CP-V has a number of performance measurements 
built directly into the system. Commands of the Control 
processor enable the system manager to display these mea- 
surements and to "tune" the system as needed by setting new 
values for the parameters that control system performance. 
(Reference: CP-V/SM Reference Manual, 90 16 74. J 



KATES 

The Rates processoi allows the system manager to set relative 
charge weights on the utilization of system services. 

Specific items to which charge weights may be assigned 
incluae 

1. CPU time. 

2. CPU time multiplied by core size. 

3. Terminal interactions. 

4. I/O CALs. 

5. Console minutes. 

6. Tapes and packs mounted. 

7. Page-date storage. 

8. Peripheral I/O cards plus pages. 

(Reference: CP-V/SM Reference Manual, 90 16 74.) 



SYSTEM MANAGEMENT PROCESSORS 

System management processors furnish the manager of a 
CP-V icisfailaliun with on-iine control of the system. Four- 
teen system management processors are supplied. 



FIX 



The Fix processor enables the system manager to repair or 
delete damaged file directories. It also provides HGP 
reconstruction for private disk pack sets and the public 
file system. (Reference: CP-V/OPS Reference Man- 
ual, 90 16 75. ) 



SUPER 

Super gives the systen manager control over the entry of 
users and the privfleg ;s extended to users. Through the use 
of Supe commands, tl e system manager may add and delete 
users, spicily how much core and disk storage space a 
user will have, spec fy i.ow many central site magnetic 
tape units a user will have, grant certain users, such as 
system programmers, soec:iai privileges, (e.g., the privilege 
of examining, accessing, and changing the monitor), and 







Registered trademark of the Teletype Corporation 



FILL 

The FILL processor performs three basic file maintenance 
functions: 

1. It copies files from disk to tape as a backup. 

2. It restores files from tape to disk. 

3. It deletes files from disk. 

(Reference: CP-V/OPS Reference Manual, 90 16 75.) 



'rocessors 



FSAVE 



GRANULE ACCOUNTING CLEANUP PROCESSOR (GAC) 



The Fast Save (FSAVE) processor is designed to save disk 
files on tape at or near tape speed. The processor is faster 
than any other file saving procedure under CP-V. (Ref- 
erence: CP-V/OPS Reference Manual, 90 16 75.) 



FRES 



The File Restore (FRES) processor is designed to restore to 
disk files that were saved on tape by FSAVE or Fill. (Ref- 
erence: CP-V/OPS Reference Manual, 90 16 75.) 



VOL1NIT 

VOLINIT provides for the initialization of public and pri- 
vate disk packs. It is used to establish serial numbers and 
ownership, to write headers and other system information in 
selected areas of the volumes, and to test the surface 
of the disks and select alternate tracks to be used in 
place of flawed tracks. (Reference: CP-V/OPS Reference 
Manual, 90 16 75. ) 



LABEL 



The Granule Accounting Cleanup (GAC) processor correlates 
information between the file DISKPOOLand the account 
authorization file, :USERS. DISKPOOL is created by the 
FSAVE processor and contains specific account information. 
Each account record in DISKPOOL contains an entry for 
accumulated public disk pack granules and an entry for ac- 
cumulated RAD granules. When GAC is run, these accumu- 
lated values are compared against the maximum values for 
the corresponding accounts in the :USERS file and the user's 
entry in the :USERS file is updated to reflect the latest 
accumulated values for RAD and disk. When the accumu- 
lated RAD or disk granules exceed the corresponding maxi- 
mum values, this fact is noted in the report that is produced 
by the GAC processor. (Reference: CP-V/OPS Reference 
Manual, 90 16 75. ) 



DEVDMP 

The Device Save/Restore processor (DEVDMP) is a stand- 
alone utility program designed to dump entire disk volumes 
to magnetic tapes for restoration at a later time. Restora- 
tion may only be made to an identical storage unit. (Ref- 
erence: CP-V/OPS Reference Manual, 90 16 75.) 



The Label processor initializes ANS tapes by writing ANS 
formatted labels. It may also be used to create "unlabeled" 
tapes from new tapes to be used as scratch tapes and to 
print the contents of the header and trailer labels of 
labeled tapes or the first 80 bytes of each block on un- 
labeled tapes. (Reference: CP-V/OPS Reference Man- 
ual, 90 16 75.) 



LANGUAGE PROCESSORS 

Language processors translate high-level source code into 
machine object code. Eight processors of special importance 
are described below. All of these can be used in both on- 
line and batch mode. 



STATS 

The STATS processor displays and collects performance data 
on a running system and produces snapshot files to be dis- 
played by the report generator Summary. (Reference: 
CP-V/SM Reference Manual, 90 16 74.) 



SUMMARY 

The Summary processor provides a global view of system 
performance by formatting and displaying the statistical 
data collected by STATS. (Reference: CP-V/SM Reference 
Manual, 90 16 74.) 



XEROX EXTENDED FORTRAN IV 

The Xerox Extended FORTRAN IV language processor con- 
sists of a comprehensive algebraic programming language, a 
compiler, and a large library of subroutines. The language 
is a superset of most available FORTRAN languages, con- 
taining many extended language features to facilitate pro- 
gram development and checkout. The compiler is designed 
to produce efficient object code, thus reducing execu- 
tion time and core requirements, and to generate extensive 
diagnostics to reduce debugging time. The library contains 
over 235 subprograms and is available in a reentrant ver- 
sion. Both the compiler and run-time library are reentrant 
programs that are shared among all concurrent users to re- 
duce the utilization of critical core resources. 



SYSCON 

SYSCON is a system control processor that can be used to 
partition resources from the system, to return resources to 
the system, and to display the status of the various system 
resources. SYSCON can also be used to build, update, or 
display the M:MODNUM file, a file which contains device 
and controller model numbers. (Reference: CP-V/SM Ref- 
erence Manual, 90 16 74.) 



The principal features of Xerox Extended FORTRAN IV are 
as follows: 

• Extended language features to reduce programming 
effort and increase range of applications. 

• Extensive meaningful diagnostics to minimize debug- 
ging time. 
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• In-line symbolic code to reduce execution time of 
critical parts of the program. 

• Overlay organization for minimal core memory 
utilization. 

• Compiler produced reentrant programs. 

(Reference: Extended FORTRAN IV/LN Reference Man- 
ual, 90 09 56, and Extended FORTRAN IV/OPS Reference 
Manual, 90 11 43.) 



META-SYMBOL 

Meta-Symbol is a procedure-oriented macro assembler. It 
has services that are available only in sophisticated macro 
assemblers and a number of special features designed to 
permit the user to exercise dynamic control over the para- 
metric environment of assembly. It provides users with a 
highly flexible language with which to make full use of 
the available hardware capabilities. 

Meta-Symbol may be used in either batch or on-line mode. 
When used in on-line mode, the assembler allows programs 
to be assembled and executed on-line but does not allow 
conversational interaction. 

One of the many Meta-Symbol features is a highly flexible 
list definition and manipulation capability. In Meta- 
Symbol, lists and list elements may be conveniently rede- 
fined, thus changing the value of a given element. 

Another Meta-Symbol feature is the macro capability. 
Xerox uses the term "procedure" to emphasize the highly 
sophisticated and flexible nature of its macro capability. 
Procedures are assembly-time subroutines that provide the 
user with an extensive function capability. Procedure def- 
inition, references, and recursions may be nested up to 
32 levels. 

Meta-Symbol has an extensive set of operators to facilitate 
the use of logical and arithmetic expressions. These opera- 
tors facilitate the parametric coding capabilities available 
with Meta-Symbol (parametric programming allows for dy- 
namic specification of both "if" and "how" a given state- 
ment or set of statements is to be assembled). 

Meta-Symbol users are provided with an extensive set of 
directives. These directives, which are commands intrinsic 
to the assembly, fall into three classes: 

1. Directives that involve manipulation of symbols and 
are not conditionally executed. 

2. Directives that allow parametric programming. 

3. Directives that do not allow parametric programming. 

A number of intrinsic functions are also included in Meta- 
Symbol. These give the user the ability to obtain Informa- 
tion on both the structure and content of an assembly time 
construct. For example, the user can acquire information 



on the length of a certain list. He can inquire about a 
specific symbol and whether it occurs in a procedure refer- 
ence. (Reference: Meta-Symbol/LN, OPS Reference Man- 
ual, 90 09 52.) 



AP 



Assembly Program (AP) is a four-phase assembler that reads 
source language programs and converts them to object lan- 
guage programs. AP outputs the object language program, 
an assembly listing, and a cross reference (or concordance) 
listing. AP is available in both the on-line and batch 
modes. 

The following list summarizes AP's more important features 
for the programmer: 

• Self-defining constants that facilitate use of hexa- 
decimal, decimal, octal, floating-point, scaled fixed- 
point, and text string values. 

• The facility for writing large programs in segments 
or modules. The assembler will provide information 
necessary for the loader to complete the linkage be- 
tween modules when they are loaded into memory. 

• The label, command, and argument fields may contain 
both arithmetic and logical expressions, using constant 
or variable quantities. 

• Full use of lists and subscripted elements is provided. 

• The DO, DOl, and GOTO directives allow selective 
generation of areas of code, with parametric constants 
or expressions evaluated at assembly time. 

• Command procedures allow the capability of generating 
many units of code for a given procedure call line. 

• Function procedures return values to the procedure call 
line. They also provide the capability of generating 
many units of code for a given procedure call line. 

• Individual parameters on a procedure call line can be 
tested both arithmetically and logically. 

• Procedures may call other procedures, and may call 
procedures recursively. 



BASIC 

BASIC is a compiler and programming language based on 
Dartmouth BASIC. It is, by design, easy to teach, learn, 
and use. It allows individuals with little or no programming 
experience to create, debug, and execute programs via an 
on-line terminal. Such programs are usually small tomedium 
size applications of a computational nature. 

BASIC is designed primarily for on-line program development 
and execution, or on-line development and batch execu- 
tion. In addition, programs may be developed and executed 
in batch mode. 
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BASIC provides two user modes of operation. The editing 
mode is used for creating and modifying programs. The 
compilation/execution mode is used for running completed 
programs. This arrangement simplifies and speeds up the 
program development cycle. 

Statements may be entered via a terminal and immediately 
executed. The principal benefit of direct execution is on- 
line development of programs and short simple computations. 
During execution, programs may be investigated for loop 
detection, snapshots of variables may be obtained, values 
of variables may be changed, flow of execution may be re- 
routed, and so on. This unique capability allows an on- 
line terminal to be used as a "super" desk calculator. 

At compile and execute time, the user may specify if an 
array dimension check is to be made. In the safe mode, 
statements are checked to verify that they do not reference 
an array beyond its dimensions. In the fast mode, this 
time consuming check is not made. Thus, the safe mode 
could be used during checkout, and the fast mode could be 
used to speed up execution when the program reaches the 
production stage. 



The FLAG debug mode is a user-selected option that gener- 
ates extra instructions in the compiled program to enable 
the user, during program execution, to detect errors in pro- 
gram logic that might otherwise go undetected or cause un- 
explainable program failure. (Reference: FLAG/Reference 
Manual, 90 16 54.) 



ANS COBOL 

The Xerox ANS COBOL compiler offers the user a powerful 
and convenient programming language facility for the im- 
plementation of business or commerical applications. The 
language specifications fully conform to the proposed ANSI 
standard for the various functional processing modules. 
Only those language elements that cause ambiguities or are 
seldom used have been deleted. The compiler's design 
takes full advantage of the machine's unique hardware 
features, resulting in rapid compilation of source code, 
rapid execution of the resulting object code, and the gen- 
eration of compact programs. The result is a highly efficient 
programming system requiring a minimum amount of storage. 



BASIC provides an image statement that uses a "picture" of 
the desired output format to perform editing. It also has 
TAB capability and a precision option to indicate the num- 
ber of significant digits (6 or 16) to be printed. 

An easy-to-use feature is provided to allow the user to read, 
write, and compare variable alphanumeric data. This is 
particularly important for conversational input processing. 



Xerox ANS COBOL contains many facilities that are either 
not found in other systems or, if available, are provided 
only at greater cost in terms of equipment required. Some 
of the facilities that provide more flexibility and ease of 
use in program development include 



1. Implementation of table handling mode. 



Chaining permits one BASIC program to call upon another 
for compilation and execution without user intervention. 
Thus, programs that would exceed user core space may be 
segmented, and overlay techniques may be employed via 
the chaining facility. (Reference: BASIC/Reference Man- 
ual, 90 15 46.) 



2. Sort/merge linkage. 



3. Sequential access. 



4. Random access linkage. 



FLAG 

FLAG (FORTRAN Load and Go) is an in-core FORTRAN 
compiler that is compatible with the FORTRAN IV-H class 
of compilers. It can be used in preference to the other 
FORTRAN compilers when users are in the debugging phase 
of program development. FLAG is a one-pass compiler and 
uses the Extended FORTRAN IV library. Included in the 
basic external functions are the Boolean functions IAND 
(AND), IEOR (exclusive OR), and IOR (OR), which give 
the FORTRAN user a bit manipulation capability. 



5. Segmentation. 



6. Report writer. 



7. Library utilization, 



8. Calling sequence for FORTRAN, Meta-Symbol, etc. 



If several FLAG jobs are to be run sequentially, they may 
be run in a sub-job mode, thus saving processing time nor- 
mally needed for the Control Command Interpreter (CCI) to 
interpret the associated control cards. In this mode, 
FLAG will successively compile and execute any number 
of separate programs, thereby reducing monitor overhead. 



9. Packed decimal as well as floating-point arithmetic 
formats. 



10. Data name series options for ADD, SUBTRACT, MUL- 
TIPLY, DIVIDE, and COMPUTE verbs. 



Processors 



The system provides the user with a comprehensive set of 
aids to minimize the time required to print "bug-free" pro- 
grams in the form of listings. These listings include 



1. The source language input to the compiler with inter- 
spersed English language diagnostic messages. 



An optional listing of the relocatable binary output, 
printed in line number sequence identical to the source 
language listing. 



3. A cross-reference listing, indicating by line number 
where each data name or paragraph name is defined in 
the COBOL program and where each reference is 
located. 



In addition, at run time, the user may use TRACE and 
EXHIBIT to follow execution of the procedure division. 



The compiler is designed to take full advantage of high- 
speed, random access secondary storage (e.g., RAD stor- 
age). This feature means faster job execution because of 
minimized I/O delays, and smaller core memory require- 
ments because of rapid overlay service. (Reference: ANS 
COBOL/LN Reference Manual, 90 15 00.) 



RPG 



Xerox RPG (Report Program Generator) is a convenient 
means of preparing reports from information available in 
computer-readable forms, such as punched cards, magnetic 
tape, and magnetic disks. In addition, it is a means of 
establishing and updating files of information, usually in 
conjunction with preparation of reports. 

RPG provides its capabilities through generation (compila- 
tion) of object programs, each of which is tailored to pro- 
duce adifferent set of reporting results and/or file processing 
desired by the user. The RPG object programs are capable 
of accepting input data, retrieving data from existing files, 
performing calculations, changing formats of data, updating 
existing files, creating new files, comparing data values 
to one another and to specified constants to determine 
appropriate handling, using user-defined processing sub- 
routines, using system library subroutines, and printing re- 
ports derived from the input and file data. 

Xerox RPG has several advantages over the more traditional 
method of writing object programs in a symbolic programming 
language. The RPG language is oriented toward the user's 
problem, describing reporting requirements, rather than 
toward the mechanics and manipulations of computer usage. 
The language and specification techniques are easily learned. 
A user can become proficient in RPG after writing only a 
few programs, whereas an equal facility in symbolic pro- 
gramming would require considerable experience. (Ref- 
erence: RPG/Reference Manual, 90 19 99.) 



APL 



APL is an acronym for A Programming Language, the lan- 
guage invented by Kenneth Iverson. It is an interpretive, 
problem-solving language. As an interpretive language, 
APL does not wait until a program is completed to compile 
it into object code and execute it; instead, APL interprets 
each line of input as it is entered to produce code that is 
immediately executed. As a problem-solving language, 
APL requires minimal computer programming knowledge; a 
problem is entered into the computer and an answer is re- 
ceived, all in the APL language. 



SIMULATION LANGUAGE (PROGRAM PRODUCT)' 

The Simulation Language (SL-1) is a simplified, problem- 
oriented digital programming language designed specifically 
for digital or hybrid simulation. SL-1 is a superset of CSSL 
(Continuous System Simulation Language), the standard 
language specified by Simulation Councils, Inc., for 
simulation of continuous systems. It exceeds the cap- 
abilities of CSSL and other existing simulation languages 
by providing hybrid and real-time features, interactive 
debugging features, and a powerful set of conditional trans- 
lation features. 



Because APL is powerful, concise, easy to learn, and easy 
to use, if is widely used by universities, engineers, and 
statisticians. It also has features that make it attractive 
for business applications where user interaction and rapid 
feedback are key issues. One of APL's major strengths is 
its ability to manipulate vectors and multidimensional arrays 
as easily as it does scalar values. For example, a matrix 
addition that might require a number of statements and 
several loops in other languages can be accomplished as 
A + B in APL. This type of simplification exemplifies APL's 
concise power. (Reference: APL/LN,OPS Reference Man- 
ual, 90 19 31.) 



SL-1 is primarily useful in solving differential equations, a 
fundamental procedure in the simulation of parallel, con- 
tinuous systems. To perform this function, SL-1 includes 
six integration methods and the control logic for their use. 
In hybrid operations, SL-1 automatically synchronizes the 
problem solution to real-time and provides for hybrid input 
and output. 

Because of the versatility of Xerox computing systems and 
the broad applicability of digital and hybrid simulation 



See "program product" in glossary. 
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techniques, applications for SL-1 exist across the real-time 
spectrum. The library concept of SL-1 allows the user 
to expand upon the Xerox supplied macro set and facil- 
itates the development of macro libraries oriented to any 
desired application. (Reference: SL-l/Reference Man- 
ual, 90 16 76. ) 



EXECUTION CONTROL PROCESSORS 

Processors in this group control the execution of object pro- 
grams. Delta and COBOL On-Line Debugger can be used 
in on-line mode only. Load can be used in batch mode 
only. Link and FDP can be used in either batch or on- 
line mode. 



LINK 

Link is a one-pass linking loader that constructs a single 
entity called a load module, which is an executable pro- 
gram formed from relocatable object modules (ROMs). Link 
is designed to make full use of mapping hardware. It is not 
an overlay loader. If the need for an overlay loader exists, 
the overlay loader (Load) must be called and the job must 
be entered in the batch stream. (Reference: CP-V/TS 
Reference Manual, 90 09 07. ) 



LOAD 

Load is a two-pass overlay loader. The first pass processes 

1. All relocatable object modules (ROMs). 

2. Protection types and sizes for control and dummy sec- 
tions of the ROMs. 

3. Expressions for definitions and references (primary, 
secondary, and forward references). 

The second pass forms the actual core image and its re- 
location dictionary. (Reference: CP-V/BP Reference Man- 
ual, 90 17 64.) 



LYNX 

LYNX is a load processor that is available in both the on- 
line and batch modes. LYNX has most of the capabilities 
of the overlay loader and also provides the same control 
over internal and global symbol table construction which is 
available in the Link loader. LYNX may be viewed as a 
preprocessor for the overlay loader. After it analyzes the 
user's commands, it constructs a table of loader control in- 
formation which it then passes to the overlay loader. It is 
the overlay loader which actually performs the loading 
process. 



DELTA 

Delta is designed to aid in the debugging of programs at 
the assembly-language or machine-language levels. It 
operates on object programs and tables of internal and glo- 
bal symbols used by the programs but does not require that 
the tables be at hand. With or without the symbol tables, 
Delta recognizes computer instruction mnemonic codes and 
can assemble machine-language programs on an instruction- 
by-instruction basis. The main purpose of Delta, however, 
is to facilitate the activities of debugging by 

1. Examining, inserting, and modifying such program 
elements as instructions, numeric values, and coded 
information (i.e., data in all its representations and 
formats). 

2. Controlling execution, including the insertion of break- 
points into a program and requests for breaks on 
changes in elements of data. 

3. Tracing execution by displaying information at desig- 
nated points in a program. 

4. Searching programs and data for specific elements and 
subelements. 

Although Delta is specifically tailored to machine language 
programs, it may be used to debug any program. Delta is 
designed and interfaced to the system in such a way that it 
may be called in to aid debugging at any time, even after 
a program has been loaded and execution has begun. (Ref- 
erence: CP-V/TS Reference Manual, 90 09 07.) 

FORTRAN DEBUG PACKAGE 

The FORTRAN Debug Package (FDP) is made up of special 
library routines that are called by Xerox Extended FOR- 
TRAN IV object programs compiled in the debug mode. 
These routines interact with the program to detect, diag- 
nose, and in many cases, repair program errors. 

The debugger can be used in batch and on-line modes. An 
extensive set of debugging commands are available in both 
cases. In batch operation, the debugging commands are 
included in the source input and are used by the debugger 
during execution of the program. In on-line operations, 
the debugging commands are entered through the terminal 
keyboard when requested by the debugger. Such requests 
are made when execution starts, stops, or restarts. The de- 
bugger normally has control of such stops. 

In addition to the debugging commands, the debugger has 
a few automatic debugging features. One of these features 
is the automatic comparison of standard calling and receiv- 
ing sequence arguments for type compatibility. When appli- 
cable, the number of arguments in the standard calling se- 
quence is checked for equality with the receiving sequence. 
These calling and receiving arguments are also tested for 
protection conflicts. Another automatic feature is the test- 
ing of subprogram dummy storage instructions to determine if 
they violate the protection of the calling argument. (Ref- 
erence: FDP/Reference Manual, 90 16 77.) 
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COBOL ON-LINE DEBUGGER 

The COBOL On-line Debugger is designed to be used with 
Xerox ANS COBOL. The debugger is a special COBOL 
run-time library routine that is called by programs compiled 
in the TEST mode. This routine allows the programmer to 
monitor and control both the execution of his program and 
the contents of data-items during on-line execution. The 
debugger also allows the COBOL source program to be 
examined and modified. 

The debugger can only be used during on-line execution; 
however, programs that have been compiled for use with 
the debugger may be run in the batch mode. This is not 
recommended, though, because of the increased program 
size when the TEST mode is specified. (Reference: ANS 
COBOL/On-line Debugger Reference Manual, 90 30 60.) 



formatting, and converting data records. Additional file 
maintenance and utility commands are provided. (Reference: 
CP-V/TS Reference Manual, 90 09 07 and CP-V/BP Ref- 
erence Manual, 90 17 64. ) 



SYSGEN 

SYSGEN is made up of several processors. These proces- 
sors are used to generate a variety of CP-V systems that are 
tailored to the specific requirements of an installation. The 
SYSGEN processors are PASS2, LOCCT, PASS3, and DEF. 
PCL is used to select from various sources the relevant 
modules for system generation. PASS2 compiles the required 
dynamic tables for the resident monitor. LOCCT and PASS3 
file away and execute load card images to produce load 
modules for the monitor and its processors. DEF writes a 
monitor system tape that may be booted and used. (Refer- 
ence: CP-V/SM Reference Manual, 90 16 74.) 



SERVICE PROCESSORS 

The processors in this group perform general service func- 
tions required for running and using the CP-V system. 



EDIT 



The Edit processor is a line-at-a-time context editor desig- 
nated for on-line creation, modification, and handling of 
programs and other bodies of information. All Edit data is 
stored on disk storage in a keyed file structure of sequence 
numbered, variable length records. This structure permits 
Edit to directly access each line or record of data. 



DEFCOM 

DEFCOM makes the DEFs and their associated values in one 
load module available to another load module. It accom- 
plishes this by using a load module as input and by produc- 
ing another load module that contains only the DEFs and 
DEF values from the input module. The resultant load 
module of DEFs can then be combined with other load 
modules. DEFCOM is used extensively in constructing the 
monitor and the shared run-time libraries. (Reference: 
CP-V/BP Reference Manual, 90 16 64. ) 



Edit functions are controlled through single line commands 
supplied by the user. The command language provides for 
insertion, deletion, reordering, and replacement of lines 
or groups of lines of text. It also provides for selective 
printing, renumbering records, and context editing opera- 
tions of matching, moving, and substituting line-by-line 
within a specified range of text lines. File maintenance 
commands are also provided to allow the user to build, copy, 
merge, and delete whole files. (Reference: CP-V/TS Ref- 
erence Manual, 90 09 07.) 



SYMCON 

The Symbol Control Processor (SYMCON) provides a means 
of controlling external symbols in a load module and of 
building a global symbol table. Its primary function is to 
give the programmer a means of preventing double defini- 
tions of external symbols. It may also be used to reduce 
the number of external symbols. For example, if certain 
load modules cannot be combined because their control 
tables are too large, the tables may be reduced in size by 
deleting all but essential external symbols. (Reference: 
CP-V/BP Reference Manual, 90 17 64.) 



PERIPHERAL CONVERSION LANGUAGE 

The Peripheral Conversion Language (PCL) is a utility sub- 
system designed for operation in the batch or on-line en- 
vironment. It provides for information movement among 
card devices, line printers, on-line terminals, magnetic 
tape devices, disk packs, and RAD storage. 

PCL is controlled by single-line commands supplied through 
on-line terminal input or through command card input in the 
job stream. The command language provides for single or 
multiple file transfers with options for selecting, sequencing, 



ANLZ 

ANLZ provides the system programmer with a means of ex- 
amining and analyzing the contents of dumps taken during 
system recovery. It is called automatically by the Automa- 
tic Recovery Procedure and is executed as a ghost job. It 
may also be called by the operator to analyze tape dumps 
when recovery is not possible, or by an on-line user to 
examine crash dumps or the currently running monitor. 
(Reference: Chapter 4. ) 
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BATCH 



SORT/MERGE 



The Batch processor is used to submit a file or a series of 
files to the batch queue for execution. Through Batch pro- 
cessor commands, the following capabilities are available: 

1. A file may be inser*~d Into a f'e being submitfed for 
execution, thus bringing together more than one file 
to create a single job. 

2. Selected strings and fields existing in files being sub- 
mitted for execution may be replaced by new strings 
and fields. 

3. The results of string and field replacements can be 
examined before the job is submitted to the batch 
stream. 

4. Files to be submitted for execution may reside on tape 
or private disk pack. 

5. Jobs may be submitted to run in an account other than 
the account from which the job is submitted. 

The Batch processor may be called in either the on-line or 
the batch mode. (Reference: CP-V/TS Reference Man- 
ual, 90 09 07.) 



The Xerox Sort/Merge processor provides the user with a 
fast, highly efficient method of sequencing a nonordered 
file. Sort may be called as a subroutine from within a user's 
program or as a batch processing job by control cards. It 
is designed i operate efficiently In a minimum hardware 
environment. Sorting can take place on from 1 to 16 keys 
and each individual key field may be sorted in ascending 
or descending sequence. The sorting technique used is 
that of replacement selection tournament and offers the 
user the flexibility of changing the blocking and logical 
record lengths In explicitly structured files to different 
values in the output file. 

The principal highlights of Sort are as follows: 

1. Sorting capability allows either magnetic tapes, disks, 
or both. 

2. Linkages allow execution of user's own code. 

3. Sorting on from 1 to 16 key fields in ascending or 
descending sequence is allowed. Keys may be al- 
phanumeric, binary, packed decimal, or zoned deci- 
mal data. 



DRSP 

DRSP (Dynamic Replacement of Shared Processors) enables 
the system programmer to dynamically add, replace, or 
delete processors during normal system operation with other 
users in the system. (Reference: Chapter 7. ) 



4. Records may be fixed or variable length. 

5. Fixed length records may be blocked or unblocked. 

6. Disks may be used as file input or output devices, or 
as intermediate storage devices. 



ELLA 



7. Sort employs the read backward capability of the tape 
device to eliminate rewind time. 



The Error Log Listing program (ELLA) provides an efficient 
tool to list and sort the error data base which is automati- 
cally generated and updated by the CP-V system. (Refer- 
ence: Chapter 6. ) 



8. User-specified character collating sequence may be 
used. 

9. Buffered input/output is used. 



SHOW 

The Show processor allows the user to display his current 
maximum system services and resources, the peripheral de- 
vices that he has been authorized to use, and several other 
system user parameters. (Reference: CP-V/BP Reference 
Manual, 90 17 64.) 



APPLICATION PROCESSORS 

The application processors are intended for use for specific 
types of applications. 



(Reference: Sort-Merge/Reference Manual, 90 1 1 99. ) 



EDMS (PROGRAM PRODUCT)' 

EDMS is a generalized data management system that enables 
the user to create an integrated data base. It is designed 
to be used with COBOL, FORTRAN, and Meta-Symbol pro- 
cessors. It simplifies programming by performing most of 
the I/O logic and data base management for the applica- 
tion programmer. 



See "program product" in glossary. 
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The principal features of EDMS are as follows: 

• The user can describe data in various data structures. 
Using sets, any element can be related to any other 
element. The data structures include lists and hier- 
archies (trees). The two relationships can be combined 
to form extensive networks of data. 

• Access techniques include random, direct, indexed, 
and indirect (relative to another record). 

• An EDMS data base may consist of up to 64 monitor 
files. 

• Multiple secondary Indexes can be defined by the user 
to allow records to be retrieved via any combination 
of secondary record keys. 

• Users may construct any number of logical files or data 
bases within on EDMS file. 

• Data is described separately from the user program to 
facilitate management of the data base. 

• Comprehensive security exists at all levels of a file. 

• Journalization provides an audit trail for backup and 
recovery. 

• A dynamic space inventory is maintained to facilitate 
rapid record storage and to optimize the use of avail- 
able storage space. 

• Detailed data description is provided for inclusion into 
the user's application program to reduce programming 
effort. 

• File I/O logic is performed for the user program 
including 

1. Logical or physical record deletion. 

2. Record retrieval on random or search basis. 

3. Record insertion or modification. 
(Reference: EDMS/Reference Manual, 90 30 12.) 

GPDS (PROGRAM PRODUCT)' 

The General Purpose Discrete Simulator provides engineers 
and administrators, whose programming experience is mini- 
mal, with a system for experimenting with and evaluating 
system methods, processes, and designs. Providing a means 
for developing a broad range of simulation models, it allows 
organizing, modeling, and analyzing the structure of a sys- 
tem, observing the flow of traffic, etc. Potential applica- 
tions include 

• Advanced management planning. 

• Analysis of inventory or financial systems. 



• Studies of message switching and communications 
networks. 

• Risk and capital investment studies. 

• Evaluation and data processing systems. 

• Job shopand queuing studies. 

Although GPDS is compatible with other simulator systems, 
it has a number of salient features not usually found in 
competitive versions. (Reference: GPDS Reference Man- 
ual, 90 17 58. ) 

MANAGE (PROGRAM PRODUCT) 1 " 

Manage is a generalized file management system. It is 
designed to allow decision makers to make use of the computer 
to generate and update files, retrieve useful data, and gen- 
erate reports without having a knowledge of programming. 

Manage consists of four subprograms: Dictionary, Fileup, 
Retrieve, and Report. The Dictionary subprogram is a data 
file and is the central control element in the Manage sys- 
tem. It consists of definitions and control and formatting 
parameters that precisely describe the characteristics of a 
data file. The Fileup subprogram initially creates and then 
maintains a data file. The Retrieve subprogram extracts data 
from a data base file according to user -specified criteria. 
The Report subprogram automatically prepares printed reports 
for data extracted by the Manage retrieval program. (Ref- 
erence: Manage/Reference Manual, 90 16 10. ) 



CIRC (PROGRAM PRODUCT)' 

CIRC is a set of three computer programs for electronic cir- 
cuit analysis: CIRC-DC for dc circuit analysis, CIRC-AC 
for ac circuit analysis, and CIRC-TR for transient circuit 
analysis. The programs are designed for use by a circuit 
engineer, and require little or no knowledge of programming 
for execution 

CIRC can be executed with three modes of operation pos- 
sible: conversational (on-line) mode, terminal batch entry 
mode, and batch processing mode. The system manager will 
determine which of these modes are available to the engi- 
neer, based on type of computer installation and other in- 
stallation decisions. 

• The on-line mode offers several advantages since it 
provides true conversational interaction between the 
user and computer. Following CIRC start-up procedures, 
CIRC requests a control message from the user. After 
the control message is input (e.g., iterate a cycle of 
calculations with changed parameters) the computer 
responds (via CIRC) with detailed requests for appli- 
cation data. These requests are sufficiently detailed to 



See "program product" in glossary. 
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virtually eliminate misunderstandings by the engineer. 
This mode is highly useful in a highly interactive en- 
vironment that produces a low volume of output and 
requires limited CPU time. 

The terminal batc^ entry mode allows efficient handling 
of high volume 01 jt and large CPU time requirements 
while preserving i advantages of the terminal as an 
input device. Two files are required, one containing 
all CIRC input including a circuit description and 
control messages and the other directing the execution 
of CIRC. The job is entered from the terminal into the 
batch queue and treated like a batch job. 

The batch mode should generally be used for jobs in- 
volving large volumes of computations and outputs. It 
enables the user to concentrate on data preparation 
with virtually no involvement in programming consider- 
ations. The system manager can provide a set of 
start-up cards that never change, and these will con- 
stitute the entire interface between user and executive 
software. However, the batch mode offers less flexi- 
bility in experimenting with a circuit and slower 
turnaround time in obtaining answers. 



(References: CIRC-AC/Reference Manual and User's Guide, 
90 16 98, CIRC-DC/Reference Manual and User's Guide, 
90 16 97, and CIRC-TR/Reference Manual and User's 
Guide, 90 17 86.) 



8. Terminal I/O Handling. 

9. Symbionts. 

10. Cooperatives. 

11. System Integrity. 

12. Initial; Jtion and Start-up. 

13. Operator Communications. 

14. Batch Debugging. 

15. Load -and -Link. 

16. System Debugging. 



The basic control system is an I/O interrupt service and 
handling routine. It includes trap and interrupt handlers, 
routines that place requests for I/O in a queue, and basic 
device I/O handling routines. 



The scheduling and swapping module makes the decision to 
swap, selects the users to swap in and out, sets up the I/O 
command chains for swap transfers, and selects the next user 
for execution. It also ensures that any associated, but not 
currently resident, shared processors are brought in with 
each user. Special algorithms control I/O scheduling and 
the balance of machine use between on-line and batch. 



USER PROCESSORS 

Users may write their own processors and add them to 
CP-V or replace CP-V processors. The rules governing the 
creation and modification of processors are described in 
Chapter 7. 



MONITOR 

The monitor responds to the moment -by-moment require- 
ments of controlling machine operation, switching between 
programs requiring service, and providing services at the 
explicit request of the user's program. The monitor pro- 
grams that perform these functions are listed below. 

1. Basic Control. 

2. Scheduling and Swapping. 

3. Memory Management. 

4. File Management. 

5. Multibatch Job Scheduling. 

6. Resource Management. 

7. Job Step Control. 



The memory management module controls the use of core 
and disk storage. Specifically, it controls the allocation of 
physical core memory, maintains the map and access images 
for each user, services the "get" and "free" service calls 
for memory pages, and manages the swapping disk space. 



File management routines control the content and access to 
physical files of information. These routines perform such 
functions as indexing, blocking and deblocking, managing 
of pools of granules on RADs and disk packs, labeling, la- 
bel checking and positioning of magnetic tape, formatting 
for printer and card equipment, and controlling access to 
and simultaneous use of a hierarchy of files. 



The multibat ch job sche duling routines select jobs to be run 
from the waiting input queue depending on priority and re- 
source and partition availability. 



Resource management facilities keep track of the number 
of resources of each kind (i.e., tape drives, disk spindles, 
core) that are in use. For a batch job, the multi-batch 
scheduler compares the resources required with the avail- 
able resources and does not start the job until sufficient 
resources are available. Once the job is started, the re- 
sources that are required by the job are reserved for the 
exclusive use of the job, trjereby guaranteeing that they 
will be available for the duration of the job. 



Monitor 
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Job step_ cu.iticl routines o.e entered between major segments 
of a job or on on-line ses-ron. They perform the monitor 
functions requited be*>,ie: job steps such as 

1. Processing error evil /id abort CALs. 

2. Handling moniro, oln.'ts.. 

3. ProLi'Siini iriiti; • f i :;■ exits t;> associated shared pro- 
cessor o; to land u<oy;am modules. 

4. Meryin ] DC B uasi..}; ,,t ents for execution. 

5. Checkifi) i (Stir oi'iloi i nation for individual processors. 

6. Fete hi n; j program load modi.ics into core. 



Terminal I ' ..'• hondiiny ,■' .fine:, perform read-write buffer- 
ing and extt.-rr/il inten upt horid|i>ici for J O directed to user 
terminals Ihese lowfmt"; <i<>o translate character codes, 
insert paye heodeo, si\> \' 5 'T c o rit'ol characters, simulate 
tabs, and perform oM-ier formatting tasks. 



Front End Communicat,^r.i 
handle the I/O between i 
The routines also f . o. iae 
including booting and va<; 
and availability fncHitie.-. 



Pi o. e*.,or_ (Ft CP) contr ol rout ines 
i:L- FfCP end the host computer. 
vera?;.;, control over the FECP, 
■..-.:: reliability, maintainability, 



Symbion t routines transfer data from the card reader to log- 
ical device streams on disk storage and from logical device 
streams on disk storage to the card punch or line printer. 



Cooperative routines intercept read, print, or punch com- 
mands in user programs and trunsfer data from or to logicai 
device streams residing on disk storage. The input coopera- 
tive simulates card reading from a logical device stream. 
The output cooperative builds a logical device stream using 
intercepted program output directed by the user program fa 
a line printer or card punch. 

System [nteyrity facilities provide error detection and re- 
covery capabilities This includes security to oser files and 
automatic high-speed restart in case of system failure. Suf- 
ficient information is recorded to isolate errors and failures 
caused by hardware oi software. 

initialization and start -up rou tines are stored on tape and 
are booted into core storage. After they are in core, they 
load the monitor root into core and turn control over to the 
root. The monitor root then completes the initialization 
of the monitor by starting and running the program called 
GHOST I which completes the patching of the system and 
the initialization of the sv/apping disk and hardware. 

Operator communication routines provide for communica- 
tion between the monitor and the operator. They transmit 
messages to the operator and process key-ins received from 
the operator. 



Batch de bugging routines provide batch programs with 
debugging capability through the use of procedure calls. 
Any batch, program may take a snapshot dump of a specified 
segment of memory, either on an -j< •■conditional or a con- 
ditional basis. 



System debuggi ng rou tines provide debu'. ,; j services to 
system programmers. Three debugging routines are avail- 
able. They are 

). Executive Delta-. This is a stand-alone processor and 
is essentially the same as on-line Delta. Executive 
Delta is optionally loaded at boot time along with the 
root of the monitor and monitor system tables. 

2. Analyze This program is intended foi debugging CP-V 
crash dumps. To accomplish 'his, it performs two 
major fur.rtions 

a. It summarizes the complete software environment 
at the time of the crash in a series of tables. 

b. It permits on-line interactions similar to Delta. 

3. Recover; This program provides the "bail-out" exit 
from the monitor. The error code that is transmitted 
to RECOVER defines the problem and the module that 
discovered the problem. 

Load-and- link routines give batch programs three types of 
loading and linking capability. Through the use of proce- 
dure calls, a batch program may 

1. Load an overlay segment into core storage. 

2. Store the calling program on disk storage, load the 
called program into core storage, and transfer control 
to the called program. 

3. Load a program into core storage, transfer control to 
the called program, and release the core area used by 
the calling program. 

4. Pass a command line to the called program. 

CP-V has two types of FORTRAN libraries. One type Is a 
public Hbrary and the other is a system library. In the 
standard release of CP-V, there are three FORTRAN public 
libraries. One library (Pi) contains a useful set of Extended 
FORTRAN IV run-time I ibrary routines; another (PO) contains 
PI and the FORTRAN Debug Package; the third (P4) con- 
tains PI and the FORTRAN real-time features. These three 
libraries are so constructed that a single copy is shared among 
all concurrent users. The system library contains a collec- 
tion of routines that are less frequently used than the public 
library routines. They are in library load module form and 
are loaded only with programs that reference them. 



SCHEDULING AMD MEMORY MANAGEMENT 

Scheduling and memory management routines control the 
overall operation of the system. Inputs to these routines, 
together with the current status of users as recorded by the 
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cheduler, are used to change the position of each user in 
the scheduling status queues. It is from these queues that 
selections are made for both swapping and execution. Swaps 
are set up by the selection of a high priority user that is to 
be brought into core and by pairing this user with one or 
more low priority users that are to be transferred to disk 
storage. Similarly, the highest priority user in core is 
selected for execution. 



SCHEDULER INPUTS 

System activities are reported by direct entry to the sched- 
uler, which makes changes to user status queues through a 
logical signaling table. The scheduler records inputs by 
changing the user status queues and other information asso- 
ciated with the user. In general, a table-driven technique 
is used. The received signal is on one coordinate and the 
current state of the user is on the other. The table entry 
thus defined names the routine to be executed in response 
to the given signal-state combination. Since the number 
of signals and states is large, the table technique aids in 
debugging by forcing complete specification of all the pos- 
sibilities. Inputs to the scheduler are listed in Table 1. 
The scheduler also receives control at execution of each 
CAL issued by a user program that is requesting monitor 
service. These entries (Table 2), special entries from the 
command processors, and entries from internally reported 
events drive the scheduling of the system. 



Table 1. Event Inputs Received by Scheduler (cont. ) 



Table 1 


. Event Inputs Received by Scheduler 


Event 


Meaning 


E:ABRT 


Operator aborted user. 


E:AP 


Associate shared processor with user. 


E:ART 


Activate real-time user. Interrupt has 




occurred. 


E:CBA 


COC buffer available. 


E:CBK 


Break signal received. 


E:CBL 


Number of output characters > SLTB. 


E:CEC 


TEL request (©©, © Y, or Y c ). 


E:CFB 


Cannot find COC buffer. 


E:CIC 


Terminal input message complete. 


E:CRD 


Read terminal command received. 


E:CUB 


Number of output characters = SL:UB. 


E:DPA 


RAD page available. 


E:ERR 


Operator errored user. 


E:IC 


I/O complete. 



Event 


Meaning 


E:IIP 


I/O started and now in progress. 


E:IP 


Request permission to start I/O. 


E:KO 


User removed from core. 


E:NC 


Cannot get requested core pages. 


E:ND 


Cannot get requested disk page. 


E.-NOCR 


User allowed to open or close file. 


E:NSYMD 


No symbiont disk space. 


E:NSYMF 


No symbiont file entry. 


E:NQR 


Enqueue release —resource available. 


E:NQW 


Enqueue —wait for resource. 


E:OCR 


Request permission to open or close file. 


E:OFF 


User has hung up telephone. 


E:QA 


User queued for access (e. g. , for access 




to tape or disk pack). 


E:QE 


Quantum end. 


E:QFAC 


No granules available for use. 


E:QFI 


Real-time user. Queue for interrupt. 


E:QMF 


Queue for I/O master function count too 




high. 


E:SL 


Sleep time for user. 


E:SYMF 


Symbiont file now available. 


E-.SYMD 


Symbiont disk space now available. 


E:UQA 


User dequeued for access (e.g., for ac- 




cess to tape or disk pack). 


E:UQFAC 


ALLOCAT has refreshed granule stacks. 


E:WU 


Wake-up time for user. 
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Table 2. Service Request Input to Monitor 



Source of Inputs 


Service Request Entries 


User program 


1. 


Terminal input/output request. 


(through monitor 






service calls) 


2. 


Input/output service calls for 
RAD, disk pack, or magnetic 
tape. 




3. 


Wait request. 




4. 


Program exit (complete). 




5. 


Core request (for common, 
dynamic, or specific pages). 




6. 


Real-time services. 




7. 


Program overlay (load and 
link, load and transfer). 




8. 


Debug requests. 




9. 


Miscellaneous service requests. 


Command 


1. 


Name of system programs to 


processor 




be loaded and entered (im- 
plies deletion of any current 
program). 




2. 


Continuation signal. 




3. 


Special continuation address. 




4. 


Link load -and -go-exit. 



The second function the scheduler performs consists of 
selecting a user for execution according to the priority state 
queues and the rules for batch processing. The rule is 
simple: the highest priority user whose program and data 
are in core is selected. 



USER STATUS QUEUES 

Status queues form a single priority structure from which se- 
lections for swapping and execution are made. The status 
queues form an ordered list with one and only one entry for 
each user. The position in queue is an implied bid for 
the services of the computer. As events are signaled to the 
scheduler, individual users move up and down in the prior- 
ity structure. When they are at the high end, they have a 
high priority for swapping into core and for execution. When 
they are at the low end, they are prime candidates for re- 
moval to secondary storage. This latter feature — that of 
having a defined priority for removal of users to disk stor- 
age — is an important and often overlooked aid to efficient 
swap management. It avoids extraneous swaps by making 
an intelligent choice about outgoing as well as incoming 
users. 

In addition to these primary functions, user status queues 
have other functions such as 

1. Synchronizing the presence in core of the user program 
and data with the availability of I/O devices. 

2. Queuing user programs to be "awakened" at a preestab- 
lished time. 

3. Queuing requests for entry and use of processors. 

4. Managing core memory. 

5. Queuing requests for buffers either in core or on 
disk. 

6. Queuing requests for nonresident monitor services. 
A list of the status queues is given in Table 3. 



SCHEDULER OUTPUT 

The scheduling routine performs two major functions during 
the time it is in control of the computer. The first function 
consists of setting up swaps between main core memory and 
secondary disk storage in such a way that high priority users 
are brought into core to replace low priority users that are 
transferred to disk storage. The actual swap is controlled 
by an I/O handler according to specifications prepared by 
the scheduler. These specifications are prepared according 
to the priority state queues described in the next section. 
Given a suitably large ratio of available core to average 
user size (greater than 4), the scheduler can keep swaps 
and computing close to 100 percent overlapped. 



SCHEDULER OPERATION 

To select users for execution, the scheduler searches down 
a list of the status queues for the first user in core memory. 
The highest priority user is served first. Interrupting users 
are served before those with an active input message (both 
of these take precedence over users with unblocked termi- 
nal output), then come on-line compute-bound users and 
finally, compute-bound batch jobs. Note that users in 
lower states have no current requests for CPU resources. 
Note also that as each user is selected for execution, the 
status queue of the user is changed to CU. When the quan- 
tum is complete, the highest priority queue the user can 
enter is the compute queue. Users that enter any of the 
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Table 3. Scheduler Status Queues 



State 


— — — — __^_ _^ _______ 

Meaning 


SRT 


Real-time execute (0< priority < X'BF 1 ). 


SCO 


Background execute (X'CO' < 




priority ^X'F5'). 


SCI 


Background execute (priority = X'F6'). 


SC2 


Background execute (priority = X'F7'). 


SC3 


Background execute (priority = X'F8'). 


SC4 


Background execute (priority = X'F9'). 


SC5 


Background execute (priority = X'FA'). 


SC6 


Background execute (priority = X'FB 1 ). 


SC7 


Background execute (priority = X'FC 1 ). 


SC8 


Background execute (priority = X'FD'). 


SC9 


Background execute (priority = X'FE 1 ). 


SCIO 


Background execute (priority = X'FF'). 


STOB 


Terminal output blocked in core. (More 




characters than the system limit are ready 




for typing.) 


STOBO 


Terminal output blocked. Not in core. 


SIOW 


I/O wait. Users waiting for an I/O that is 




in progress to complete. 


SIOMF 


Users blocked because I/O master function 




count (number of I/O operations in progress) 




has reached the system limit. 


SW 


Users waiting for a specified "wake-up" 




time. 


SQA 


Users waiting for service by RBBAT, the 




symbiont ghost. 


SQR 


Users in core and blocked for dynamic re- 




source such as swapper page, COC buffer, 




symbiont disk page, symbiont table space, 




enqueued resource, service by ALLOCAT 




(for file granules), or file open or close. 


SQRO 


Same as SQR but not in core. 


STI 


Typing input and in core. 


STIO 


Typing input and not in core. 


SQFI 


Real-time user waiting for interrupt. 



three highest priority states receive rapid response but only 
for the first quanta of service. Thereafter, they share ser- 
vice with others in the compute queue. 

A similar selection procedure is used to set up users for 
swapping. First, the highest priority user in the execution 
queue who is not in core is selected and his size require- 
ment (including the requirement for shared processors not in 
core) is determined. Second, users are selected from the 
swapout queue until enough space is freed by these users 
and their shared processors to provide for the user selected 
for swap-in. If a single user in a state below SCIO (Table 3) 
can be found to swap out, then a single rather than a multi- 
ple swap is chosen. No swaps occur until a user that is not 
in core enters a high priority queue. 

Two lists resulting from this selection are presented to the 
swapper. One list contains the user (or users) to be swapped 
out and the other contains the user to be swapped in. This 
latter list also contains the shared processors that must 
accompany the user and the current free core page list. 
When the scheduler selects users for swapping, it picks a 
high priority user to load into core and the lowest priority 
user to remove from core. Priorities are arranged from high 
to low, in order of increasing expected time before the next 
activation. This ensures that the users that are least likely 
to be needed are swapped out first, while the users most 
likely to require execution are retained in core. The swap 
algorithm operates so that compute users remain in core and 
use all available compute time, while the interactive users 
are swapped through the third core slot whenever the fol- 
lowing three conditions exist: 

1. There is room in core for three user programs. 

2. Two users are computing steadily. 

3. Many other users are doing short interactive tasks. 



Table 4 shows the queue used for selection of users to be 
brought in for execution and the queue used for selection 
of users to be moved to disk. 



Note that the queues CU, IOW, QRO, TOBO, TIO do not 
appear in either list. Thus, the users in these states are not 
selected either for execution or for swapping. 

Two examples of typical interactive use are illustrative of 
the scheduling operation. 

The first example traces scheduling operations for a simple, 
short interactive user request. At the time the request is 
typed, the user is in the STI queue. His program, which 
has probably been swapped to disk storage, remains there 
until the COC routines receive an activation character. 
Receipt of this character is reported to the scheduler 
and causes a change in state of the user to the appro- 
priate executable state (SC0-SC10). The scheduler finds 
a high priority user not in core and initiates a swap to 
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Table 4. Swap-In and Swap-Out Queues 



Swap-In 




(and Execution) 


Swap-Out 


Queue 


Queue 


SRT 


SW 


SCO 


STI 


SCI 


STOB 


SC2 


SQFI 


SC3 


SQA 


SC4 


SC10 


SC5 


SQR 


SC6 


SC9 


SC7 


SC8 


SC8 


SC7 


SC9 


SC6 


SC10 


SC5 




SC4 




SC3 




SC2 




SCI 




SCO 




SRT 



this typing time, the program is not required in core and 
the CPU resources can be given to other programs. 



remove a low priority user (if necessary) and to bring 
in the one just activated. On completion of the swap, 
the scheduler is again called and now finds a high priority 
user ready to run. The user's state is changed to CU, the 
program is entered, and the input command is examined by 
the reading program. The cycle in this example is com- 
pleted by preparation of a response line and a request to 
the monitor for more input which changes the user's state 
to TI again, making him a prime candidate for removal 
to disk. 



I/O SCHEDULING 

I/O scheduling is designed to provide good service to I/O- 
bound users while keeping the CPU busy with compute- 
bound users. The intent is to make the fullest possible 
utilization of both the CPU and the I/O devices. The 
manner in which this is accomplished is described below. 



A user that has been waiting for an I/O to complete (SIOW) 
is changed to an executable state at a priority slightly 
higher than a similar compute-bound user when the I/O 
completes. At that time, the execution scheduler inter- 
rupts the execution of the compute-bound user so that the 
I/O-bound user can execute. The I/O-bound user requires 
comparatively little CPU time before initiating another I/O 
request and returning to the SIOW state. The compute- 
bound user then resumes execution. 



It should be noted that the scheduler automatically adapts 
to jobs that alternate between bursts of computing and bursts 
of I/O. 



SWAP HARDWARE ORGANIZATION 

Users are removed from core to a dedicated area of disk 
storage (or to several disks in large configurations) when 
core is required for higher priority users. 



Bit tables are used to keep track of the availability of each 
sector on the disks. In these tables, a zero is used to indi- 
cate the sector is in use (usually assigned to a user) and a 
one is used to indicate the sector is available. Users are 
assigned a sufficient number of page-size sectors to accom- 
modate their current use. The assignment is done in such a 
way that command chaining of the I/O can order the sectors 
to be fetched for a single user with minimum latency. That 
is, each user's pages are spread evenly over the set of 
available sectors on the disk to which he is dedicated so 
that data will be transmitted in every disk sector passed 
over when the user is swapped. 



The second example illustrates an output-bound terminal 
program. This program moves through the state cycle STOB- 
SC-SCU as output is generated by the program. The COC 
routines signal when the output limit has been reached, 
thus causing the program to be delayed while output is 
transferred to the terminal. In a typical operation, four 
to six seconds of typing is readied in buffers each time the 
user program is brought into core and executed. During 



The records of disk sectors associated with each user are 
kept in the user's job information table (JIT), which is kept 
on disk when the user is not in core. The disk location of 
the JIT and the user's disk address are kept in core by the 
scheduler. The disk layout is such that sufficient time is 
available after the user's JIT arrives from the disk for the 
system to set up the I/O commands for the remainder of 
the user. 
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The amount of disk storage assigned to swapping is a 
parameter of SYSGEN. The number of on-line users that 
the system can accommodate is limited by the size of disk 
space allocated for swapping and the total size of active 
on-line users. 



Due to the system configuration and SYSGEN, at most 
six sets of devices can be created: 



1. RAD all PFA (PFA RAD first). 



The allocation scheme for systems which have file space 
allocated on both RADs and disk packs is described in the 
following paragraphs. 



2. Pack all PFA (PFA pack first). 

3. All PER (PER first). 



For the sake of overall performance, the RAD is preferred 
for frequently accessed system information and temporary 
files used by the major processors. Special users who 
need high performance on special files may specify RAD 
preference. 



4. RAD PFA plus PER and/or PSA (PFA RAD second, 
PER second). 

5. Pack PFA plus PER and/or PSA (PFA pack second, 
PER third). 



All of the account directory and all files from :SYS are as- 
signed to the RAD. The first granule of each file directory 
is assigned to disk pack but any additional granules are as- 
signed to RAD. All star or id files and all scratch files 
(opened OUT or OUTIN with REL) prefer RAD. Random 
files with no user stated preference and all other files and 
their indexes prefer pack. These pack preferences may be 
overridden either by the operator keyin 'PREFER' for all 
files or by the user specification of NOSEP and DEVICE 
for individual files. 



Briefly, the effect of authorization and defaults upon the 
allocation is: If not enough space is available on the pre- 
ferred device, the other device will be used if space is 
available there. The exception to this is random files with 
user specified preference. In this case, if space is not 
available on the user specified device, the file is not al- 
located and an error is returned to the user. Also, within 
the authorized limits, temporary files may use only tempo- 
rary authorization and permanent files may use only perma- 
nent authorization. 



In general, the rule for authorization should be: A large 
amount of temporary RAD and disk pack space should be 
authorized for all users and the amount of permanent disk 
space should be individually authorized by need. Very few 
users should be authorized permanent RAD space. 



6. PER plus PSA (PER fourth). 

Granules are selected for the in-core buffers from one of 
the six sets of devices starting each device at sector zero 
and allocating from all the devices within the set simul- 
taneously (i.e., round-robin). The preference in choice 
of sets is noted above in parentheses. All devices of a set 
will be depleted before the next set is chosen. 



Cylinders for the in-core buffer are allocated starting at 
cylinder zero of the first (lowest DCT index) cylinder al- 
located device. Each device will be depleted before the 
next is used. 



Random files are allocated starting at the last sector of the 
last (highest DCT index) device of the proper type. The 
cylinder allocated devices are treated as one continuum 
of space for random files. They need not be contiguous in 
the DCT table and any file may cross a boundary (even a 
two cylinder file). Private random files are allocated in 
the same way. 



There are four in-core buffers for types of space to be al- 
located. Three are for granule allocated devices: 

1. RAD PFA (permanent file storage). 

2. Pack PFA (permanent file storage). 

3. PER (peripheral symbiont storage). 

The fourth is for cylinder requests. These buffers are used 
to satisfy requests for all purposes except directories, random 
files, and PSA (permanent system storage and swapping). 



PROCESSOR MANAGEMENT 

CP-V processors are considered shared processors when they 
are written in such a way that they are pure procedure and 
are described as such when they are added to the system. 
(User-associated data areas are initialized at first entry.) 
A shared processor has the following special characteristics: 

1. It has dedicated residency on swap storage established 
at system initialization or via DRSP. 

2. A single copy is shared by all requesting users. 
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MEMORY LAYOUT 

The system makes full use of address mapping hardware, 
access protection, and write locks in allocating available 
physical core pages to users. Physical core pages are allo- 
cated to users at their request. Use of the map obviates 
the need for program relocation or physical moves. Full 
protection is provided for one user from another. All pro- 
grams and the monitor itself are divided into procedure and 
data. The procedure area is protected by write-locks or 
access codes, or both, against inadvertent stores. 



The central features of the use of write-locks to protect 
master mode programs are as follows: 

1. The monitor operates with a key of 01 and may store in 

a. Its own data area (LOCK = 01). 

b. Any batch, on-line or shared processor code 
(LOCK =00). 

It may not store in its own procedure (LOCK = 11). 

2. Keys of 10 and 11 are never used, nor is the lock of 10. 

3. Write-locks are initialized only once at system start-up 
and are not changed thereafter except when running 
under control of Executive Delta where they are used 
to enable data breakpoints. 

4. On the Xerox 560, write keys are four bits long and 
apply to the I OP memory writes as well as CPU write 
operations. To take advantage of this feature, the 
Xerox 560 I/O system always uses a key of 1000 which 
does not match any of the locks. This means that no 
I/O operation can accidentally overwrite the monitor or 
its data since the IOPscan only write into memory with 
locks of zero (the user area). Also on the Xerox 560, 
certain monitor buffers which are part of the monitor data 
area (usually with lock 01) are grouped together and the 
pages containing those buffers are set to a lock of 0000. 
Except for this difference, the rest of the locks are 
exactly the same as for the Sigma computers. 



The access code on virtual memory pages controls references 
made by slave mode programs (user programs and shared pro- 
cessors). This code is retained in the JIT of each user and is 
loaded into the hardware access protect registers (which are 
part of the virtual mapping hardware) when the user gains 
control. Write access to JIT and other job context areas is 
given to TEL, CO, LOGON, and any installation-defined 
command processors. 



The layout of virtual memory that applies to user programs 
and ordinarily shared processors is shown in Figure 2. Al- 
location of the available area depends on the type of 
user that is running and the attributes of the load module 



to be executed. Allocation Type II is used when a core 
library or debugger is associated or when the load module 
to be executed has been built by Link. In all other cases, 
allocation of the available area is as shown in Type I for 
batch users, ghost jobs, and on-line users executing in the 
extended memory mode. 



Core addresses shown are those appropriate for a typical 
system but more (or less) core may be established for the 
resident monitor at SYSGEN time depending on installation 
needs. More (or less) area may also be desirable for the 
library area and for the }ob context area to accommodate 
more buffers. These bounds may also be adjusted at SYSGEN 
time. The boundary at which the one-pass loader (Link) 
places the user program is also adjustable. 

Virtual pages not currently allocated to the user are mapped 
into a resident monitor page that is write-locked, (the ac- 
cess code is set to no access). Thus, slave mode programs 
are denied access through the access code, and attempts to 
store at these virtual addresses by a master mode program 
are protected by write locks. 

Typical layouts of physical memory are shown in Figure 3 
for Sigma systems and in Figure 4 for Xerox 560 systems. 
Although these are similar to the actual layout, they should 
not be assumed to be exact. 



SYSTEM INTEGRITY 

The monitor has a number of routines that have been in- 
cluded to guarantee system integrity. The objectives of 
these routines are, in order of importance, (1) to provide 
the highest possible security for user files even in the event 
of total system failure, (2) to provide automatic high-speed 
recovery in the event of a machine or software failure, and 
(3) to record sufficient information to isolate errors and 
failures caused by either hardware or software. 

The major features of the CP-V system integrity routines are 
as follows: 

1. Detection of malfunctions by hardware examination 
and software checks wherever the checks have been 
shown to enhance hardware error detection. Recovery 
from these malfunctions is through retries, operator as- 
sistance, etc. 

2. Logging of all malfunctions, including recovered errors 
and permanent failures. 

3. Protection from hardware failures. 

4. Use of on-line exercisers to provide for repair or ad- 
justment of peripherals without taking the CPU down. 

5. File backup and recovery facilities to minimize the 
probability of losing user files, and in case of file 
failure, to facilitate complete recovery of the file sys- 
tem with a minimum of loss. 
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Procedure 
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Procedure 



User 
access 
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Contents Context Area 



Job information 
File blocking buffers 
File index buffers 
Coop buffers 



Available Area 

User programs, data, DCBs, and symbol tables 
Ordinary shared processors including 

Root segment 

Initial data 

Overlay area 



Special Area 

Special shared processor and data: 
Link 
Delta 
TEL 
Libraries 



Access none — no access of any kind permitted 

codes read — read access only 



execute —execute or read access 

write —write, execute, and read permitted 



Figure 2. Typical User Program — Virtual Memory Layout (not to scale) 



Keys 



01 
Resident monitor 


00 

On-line jobs 
Batch jobs 
Shared processors 


Data 


Program 





Locks 



01 



11 



00 



Unused keys: 10, 11 
Unused locks: 10 



Figure 3. Typical Memory Layout for Sigma Computers (not to scale) 
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Keys 



0001 
Resident monitor 


All 


0000 
user jobs and processors 


Data 


I/O buffer 


Data 


Program 




0001 


0000 


0001 


0011 




0000 



Locks 



(The I/O system always uses a write key of 1000.) 



Figure 4. Typical Memory Layout for the Xerox 560 (not to scale) 



6. Automatic recovery following a system failure with 
reasonable speed consistent with file security and the 
recording of information for later analysis. 

7. Facilities to provide for analysis of system crashes. In- 
formation includes simple classification of failures as 
well as full information for both customer engineers 
and system programmers. 

8. For the Xerox 560 — on-line interface for remote 
assistance. 



ERROR AND FAILURE LOGGING 

Malfunction messages are maintained in a special file by 
system integrity routines. Messages are placed in this file 
whenever malfunctions are detected by the various parts of 
the system. Hardware malfunctions that are recorded in- 
clude such things as tape errors, card reader errors, memory 
parity errors, and illegal instructions. Software malfunctions 
that are recorded include the failure of software checks 
on RAD or disk addresses contained in index blocks and 
improper linkage of linked file blocks. In addition, a 
software recovery from a seek failure is recorded in this 
file (as a 757F code). 



ERROR DETECTION AND RECOVERY 

An effective operating system must be able to detect and, 
whenever possible, to correct errors. It must also be cap- 
able of restarting the system if necessary. CP-V uses a 
combination of hardware and software checks to efficiently 
meet these goals. 

Hardware error protection features include memory protec- 
tion against accidental overwriting of monitor and user pro- 
grams, power fail-safe interrupts that ensure automatic 
restart in the event of power failure, memory parity check- 
ing, I/O read and write verification, and a watchdog timer 
to avoid instruction hangups. Detected errors are reported, 
logged, and if possible, recovered directly. Catastrophic 
failures cause an automatic system recovery if at all pos- 
sible. Those failures which can be isolated to a single user 
cause only that user to be aborted. Some hardware errors, 
such as loss of a memory power supply, lead to system 
shutdown. 



The error messages generated throughout the system (report- 
ing both hardware and software errors) are placed initially 
in in-core buffers and then are transferred to a special file 
(actually a linked list of granules). This transfer is initiated 
whenever an error count threshold, or time limit is reached. 
This special file is then transferred to an ordered keyed file 
(ERRFILE) by the standard system ghost processor ERR:FIL 
which is automatically awakened by the system. 



ERROR LOG LISTING 

This keyed file (ERRFILE) may be listed and sorted by the 
processor ELLA which allows the Customer Engineer to dis- 
play and search the error file for patterns of errors to aid in 
preventive maintenance for the system. 



Software consistency checks, some of which are performed 
optionally on the setting of a console sense switch, check 
the integrity of the software at many critical locations in 
the system. These checks detect problems before they are 
allowed to go beyond a recoverable point. When an incon- 
sistency that is catastrophic to the system is detected, the 
current users are logged off and all open files are closed. 
The system is then automatically rebooted for the fastest 
possible restart. 



ON-LINE DIAGNOSTICS AND EXERCISERS 

On-line diagnostics and exercisers may be called when 
there is a specific failure detected by the hardware or soft- 
ware, or when a failure is projected through analysis of the 
error log by the Customer Engineer. These programs may 
also be called by the Customer Engineer when needed for 
the test or adjustment of the card reader, card punch, line 
printer, magnetic tape, or other devices. 
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REMOTE DIAGNOSTIC ASSISTANCE 

On the Xerox 560, on-line diagnostics and certain on-line 
debugging processors (ANLZ, Delta, and ELLA) may be 
utilized via the Remote Assist Station (RAS) interface. 

After control is obtained from the local operator, customer 
engineers and/or diagnostic programmers at remote locations 
may access the system via this interface without interfering 
with the on-line COC users and without using any of the 
normal communication equipment. By evaluating the sys- 
tem under normal operating conditions, many software errors 
and hardware malfunctions may be detected and eliminated 
expeditiously with a minimum of computer down time. 



FILE MAINTENANCE 

CP-V provides a variety of processors designed to maintain 
a reliable backup of the file data base. These processors are 
summarized in the CP-V/SM Reference Manual, 90 16 74, 
and are described in detail in the CP-V/OPS Reference 
Manual, 90 16 75. The processors provide the ability to 
save and restore large volumes of files very quickly, to save 
and restore entire private and public disk devices at device 
speed, to handle user initiated backup of files, to restore 
the allocation tables for public disks after a system crash, 
to restore the allocation tables for a private disk pack after 
a crash which affected the pack, and to restore granule ac- 
count information in the :USERS file. 



AUTOMATIC RECOVERY AFTER SYSTEM FAILURE 

The CP-V monitor performs consistency checks on the 
results of hardware operations, checks intermediate results 
of operating system software functions, performs checks and 
balances at appropriate interfaces between the operating 
system's modules, and monitors itself for unexpected trap 
conditions caused by the hardware or operating system soft- 
ware. A software check code is assigned to each type 
of failure that the monitor may detect. 

Some of these software check failures result in a momentary 
delay in service to all but the current user for whom the 
operating system is performing a service. In such case, 
the current user's job step is aborted, core is dumped to a 
file for later analysis and display, and normal operating 
then continues. The remaining software check failures are 
handled by the system's recovery routine. 

The recovery routine performs the following functions: 

1. Displays cause of failure. 

2. Takes a full core dump for later analysis. 

3. Closes all open files with default options. 

4. Packages or releases all partial symbiont files. 



5. Closes common TP journal if transaction processing is 
being used. 

6. Saves in-core transaction processing files. 

7. Packages error log. 

8. Informs users of interruption. 

9. Saves time, data, error log pointers, accounting infor- 
mation, symbiont file directory, public disk granule 
usage map, and executive communication. 

10. Restarts system and restores items saved above. 

When functions cannot be performed, they are noted on the 
operator's console. If the function is considered minor, re- 
covery continues. If it is connected with file operations, 
the file identification is noted and recovery proceeds. 



The recovery routine described above occurs automatically 
with a minimum delay (a few seconds) in system availability. 
Operator initiation of this recovery function is also allowed, 
providing for the event that the system fails by not respon- 
ing to any operator key-in or user service request. 



When the recovery routine executes, it is independent of 
all monitor services and functions and requires only that a 
small recovery driver be intact in memory. This driver 
reads the main recovery module into memory from the system 
swap device, overlaying the pure procedure portion of 
CP-V. Certain monitor system tables are also required in- 
tact for successful recovery. These tables are verified 
before proceeding. If the recovery process cannot be com- 
pleted, the operator is instructed to initialize the system 
from the master system tape and restore files and backup 
tapes. 



CRASH ANALYSIS 

In the event of a recovery or single user abort, one of the 
recovery functions is to dump the contents of core memory 
into a special file in the :SYS account. This information is 
saved for later analysis by a system programmer using a 
special debugging program, ANLZ. 



The ANLZ program may be called by the operator or system 
programmers to run as a privileged ghost, on-line, or batch 
job. The ANLZ program is also called automatically 
as a privileged ghost job by the recovery routine as one 
of the first jobs following a recovery or the first job fol- 
lowing a single user abort. In any mode, ANLZ is command 
driven (except in the ghost mode following a recovery). 
It responds to commands that selectively display monitor 
tables, examine memory, and compare the dump with 
the running monitor. (Reference: Chapter 4.) 



Monitor 
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3. BOOTSTRAP AND PATCHING OPERATIONS 



SYSTEM TAPE FORMAT 

A CP-V system tape contains the following elements: 

1. Bootstrap loader. 

2. Root for an absolute monitor. 

3. General information record concerning this system 
tape. 

4. Other monitor segments (XDELT A, ALLOCAT, GHOST1, 
FIX). 

5. Monitor overlay segments. 

6. RECOVER. 

7. Tape label information. 

8. Files for all system load mod u I es and other needed files. 

9. Patches and GENMD commands. 

The general arrangement of the information on a master sys- 
tem tape is shown in Figure 5. 



b. A group of GENMD commands and GENMD patches 
to the processors contained on the tape. 

5. A !EOD command (the final command of the patch 
deck). 

In addition, there are two types of cards that may appear 
anywhere within the patch deck (including the GENMD 
portion). These two types are the conditional patch control 
command and the comment card. 

No patch, command, or comment may contain more than 
72 characters of information. 

When the patch deck is read, it is retained by the system in 
a file called PATCH in the :SYS account. This file can be 
examined using the PCL processor. It may also be assigned 
toM:PATCH and DEFed onto the PO tape. 



The function and format of Delta format patches, symbol def- 
inition patches, reconfiguration and partitioning commands, 
GENDCB commands, GENMD commands, GENMD patches, 
conditional patch control commands, and comment cards 
are described in the paragraphs that follow. 



PATCH DECK STRUCTURE 

Patch decks have the following structure: 
1 . The following two types of patches: 

a. Delta format patches for the monitor root and its 
overlays. 

b. Symbol definition patches. 

The monitor root, patches can appear anywhere within 
the patch deck. The overlay patches must be in the 
same order as the system tape structure. Symbol defi- 
nitions must precede the patches in which the symbol 
is used . Patches to the reconfiguration processor must 
precede the boot-time reconfiguration and partitioning 
commands and must be read from the card reader when 
the card reader is used during boot-time for patching 
purposes . 



2. 



3. 



Boot-time reconfiguration and partitioning commands. 
These are optional, but if they are used, they must pre- 
cede the first overlay patch. It is also advisable to 
read them from the card reader. 



A card that contains an asterisk in column one. This 
card terminates the monitor patches and boot-time re- 
configuration and partitioning commands. 

4. The following two types of patches (which may appear 
in any order): 

a. A GENDCB command to assign the account, a 
password, serial number, and type of tape drive 
for the boot tape. 



DELTA FORMAT PATCHES 

Delta format patches are used to patch various segments of 
the monitor. The format of a Delta format patch is: 

[segname]/loc/value[(old value)]/comment 



where 



segname is the name of the segment to be patched. 

The current segnames and the order in which they 
must be patched are shown in Figure 6. 

If a segname is present, the loc field must represent 
a location in the corresponding segment or the loc 
field (and value field) must be null. The latter 
type of patch would have the format. 

segname// (the third slash is unnecessary) 

and must be the first patch with its particular seg- 
name. (An example of this form of patch is given 
in the 'Conditional Patch Control Commands' 
section below.) 



Example; 

OPEN// START THE OPEN PATCHES 
OPEN/OPNH+.52/B PATCH/ 
/PATCH/LW,13 TABLE S+. 74/ 
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Tape 
boot 



M:MON root 
records 



System 
information 



Exec Delta 
head record 



Exec Delta 
data records 



M:MON root patches 
(optional) 





ALLOCAT, FIX, GHOST! , Monitor overlays, and RECOVER 
core image records and (optional) patches for them. 

Kj— 




Note: 



Record sizes The tape bootstrap is 22 words long. Patch records are 20 words 

long. All other records are 512 words long. The figure indicates 
groups of such physical records. 

Head Head portion of load module. 

Data Protection type portion of load module. 

Patches Patches are included on the tape where shown if they exist in the 

file assigned to the M .-PATCH DCB when DEF creates the system 
tape. The first group of M:MON root patches follows the Exec 
Delta data records. Any others are placed among segment patches 
according to their order in the patch file. The last record of each 
group of patches on the tape is the first patch for the next set of 
segment patches. The second through the last patch for a segment 
follow the segment to which they will be applied. GENMD patches 
follow the last of any patches following the RECOVER patches. 



Figure 5. Format of Master System Tape 



Patch Deck Structure 
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,., ...... ......... ..„.. ,..,. c ... 


C P 


- V 


SYSTEM GENERATED ON: 


12:00 AUG 


16, '74 


VERSION NO. 


IS: COO 


PATCH SEGMENT NAMES: 




(ROOT) 


ALLOCATO 


(DATA) 


ALL0CAT1 


( PROC ) 


FIXO 


(DATA) 


FIX2 


(DCBS) 


FIX1 


(PROC) 


GHOST10 


(DATA) 


GH0ST12 


(DCBS) 


GH0ST11 


( PROC ) 


CLOSE 


(DATA) 


DEBUG 


(DATA) 


ENQOV 


(DATA) 


KEYIN 


(DATA) 


LDLNK 


(DATA) 


LTAPE 


(DATA) 


MISOV 


(DATA) 


MULOV 


(DATA) 


OPEN 


(DATA) 


OPENTP 


(DATA) 




(DATA) 
(DATA) 


STEPOVR 


(DATA) 


TPOV1 


(DATA) 


TPOV2 


(DATA) 


UMOV 


(DATA) 


RECOVER 


(DATA) 



Figure 6. Segment Patching Order 

If no segname is present, any location between 
10] o and FFF0] o maybe patched. Such patches 
may appear anywhere within the patch deck. 

loc is a Delta format symbolic location, possibly 

with offsets. 

value is the Delta format value to be inserted at 

loc. 

old value is the Delta format value of the previous 

contents of loc. 

Example: 

/IORT+.F8/PSM.9 TSTACK(PSM,6 TSTACK)/ FIX SIDR #6646 

If a patch command is in error (e.g., has an illegal char- 
acter, an incorrect old value, a value occupying more than 
one word, or an invalid loc value), it will be typed on the 
OC device. The operator must determine what was wrong 
and correct the problem. 

If the error is apparent from examination of the patch, it 
can be corrected and the boot process restarted. Ifdesired, 
the system may be examined with Executive Delta, which 
is now in control and requesting commands at the operator's 
console. The patch in error may be corrected from the 
operator's console using Delta by entering the patch 



correction mode by keying— i® (use right bracket (J©) on 
the Xerox 560) and then the correct patch in the form given 
above. After receiving the correct patch, the system re- 
sumes reading patches. 



PATCH DECK SYMBOL TABLES 

The Delta format symbolic values that are recognized in 
patches are assembled by the system tape definition proces- 
sor, DEF, from the REF/DEF stacks of the patchable modules 
using these items: 

1. All DSECT names. 

2. All DEFs ending in a colon (the colon is removed in the 
patch deck symbol fable). 

3. The first UDEF after each CSECT unless a colon DEF 
intervened. 

4. Patch segnames. 

For M:MON only, all LDEFs are also included. The sym- 
bols obtained from M:MON and XDELTA are available to 
XDELTA at any time. Those from other modules are avail- 
able only while that module is being patched. DEF lists 
the symbols that are included as the tables are created. 

In addition, two special symbols are available during the 
patching process. 

The first is the symbol @ whose value is equal to the next 
available location in the patch area of the monitor. That 
is, it is initially equal to the monitor symbol, MPATCH, and 
its value is incremented by one each time a patch is encoun- 
tered whose loc field is equal to the current value of @. 
The use of the special symbol @ frees the user from having 
to allocate space in the PATCH area of the monitor since 
Executive Delta will automatically relocate the patch area. 

Example: 

The following two patch decks are equivalent: 



/I0RT+.F8/B 0/ 
/IORT+.FE/B 0+1/ 
/(«/LI,3 12/ 
/(a/CB,3 5/ 
/@/BNE $+2/ 
/@/B I0RT+.F9/ 
/@/LI,3 0/ 
/@/B I0RT+.F9/ 



/I0RT+.F8/B PATCH/ 
/IORT+.FE/B PATCH+1/ 
/PATCH/LI, 3 12/ 
/.+1/CB.3 5/ 
/.+1/BNE $+2/ 
/.+1/B I0RT+.F9/ 
/.+1/LI.3 0/ 
/.+1/B I0RT+.F9/ 



The second special symbol is @@ and is used when an even 
address in MPATCH is required. The only restriction on this 
special symbol is that @@ cannot be referenced while patch- 
ing @ (e.g., /@/@@/). The results are unpredictable. 
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Example: 



/MM+.64/iPSn,8 \W 
/(<tf , /MM+.6'H4** , >R/ 
A?/. 17000000/ 



New symbols may be added to the symbol table by including 
symbol definition patches in the patch deck. Symbol def- 
inition patches must have the format 

* symbol ~ value 

where 

symbol is any Delta format symbol. (The symbol 

can be no longer than eight characters.) 

value is any evaluatable expression terminated by 
a blank. 



Example: 



#GRUNCH=.D87 

/CRUNCH /B GRUNCH+.20/ 

/. + 1/B A/ 

A?/I.W,3 TABI.ES+3/ 

A?/CI,3 10/ 
/@/B GRUNCH+.50/ 



/55+.1E8/B JK/ 



In the above example, the patch at 55+.1E8 branches to 
the instruction CI, 3 10. 



RECONFIGURATION AND PARTITIONING COMMANDS 

These commands provide a means of reconfiguring the system 
and partitioning devices and/or controllers at boot-time. 
Ail of the commands begin with a colon (:) and must end 
with a period or a trailing blank by at least column 72. 
The commands may be specified in any order with the ex- 
ception of :END which must appear last (if it is used). 

If no icconfiguration and partitioning commands are speci- 
f i -»d , the system responds as if the :GO command had been 

specified. 

Reconfiguration always validates the SYSGENed device ad- 
dresses. If a device address (ndd) is encountered for which 
the n cannot be validated, the following message is displayed 
on the OC device and the boot procedure is terminated. 



CANNOT CONVERT V IN 'yyndd' 



Three of these commands (:TYPE, : PART, and : REMOVE) 
contain the following parameter as part of the command 
format: 

value (sometimes referred to as value and value 9 ) 

The description of this parameter is quite detailed. To 
avoid repeating the description several times, it will be 
given here and references will be made back to this section 
in the command descriptions. 

The format of value is dependent on the CPU being used. 

For Sigma 6/7/9 systems, value must be in the format 

ndd 

where 

n represents a controller address and is specified as 

a letter. See Table B-2 in Appendix B. 

dd specifies the device number. See Table B-3 in 

Appendix B. 

For Xerox 560 systems, value may take one of two formats. 
The first format is 

ndd 

where 

n represents a cluster number and a unit number. 

See Table B-4 in Appendix B. 

dd specifies the device number. See Table B-3 in 

Appendix B. 

The second format consists of four hexadecimal digits which 
represent a hardware address in the format 



00 



dd 



-.4 ._,- 



c specifies the cluster number, 

u specifies the .init number, 

dd specifies the device number. 



!G0 This command specifies that the configuration speci- 

fied on the system tape is to be used as is. The format of 
the command is 

:GO 

If :GO is specified, :TYPE and rREMOVE commands are not 
meaningful and the following message is output on the LL 
device: 



where n and ndd are defined in the following discussion and 
yy is the device type. 



ALL :TYPE/ : REMOVE COMMANDS IGNORED 
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iSAVE This command specifies that all device addresses 

not changed by :TYPE commands are to remain as is, except 
according to restrictions listed in fhe following description. 
The format of the command is 

:SAVE 

When the :SAVE command is specified, the following mes- 
sage is output on the LL device: 



**KEEP ALL DEV. ADDR.AS IS EXCEPT FOR .-TYPE/ 

.■REMOVE CHANGES 



When the :SAVE command is used, only those device ad- 
dresses which are different :m the target machine from that 
of theSYSGENed system tape need be changed by the -.TYPE 
command. Ail others remain as SYSGENed except when a 
:TYPE command redefines one or more device addresses for 
a specific device type where the SYSGENed IOP/controller 
or cluster/unit addresses are equivalent within the device 
type. In this case, every equivalent IOP/controller or 
cluster/unit address within that device type must be defined 
by :TYPE commands whether or not the device address needs 
to be changed or the undefined ones will be removed from 
the system. The -.REMOVE command may also be used to 
remove SYSGENed devices. 



alternate path address. When a device address 
change is required for a specific device type, all 
addresses must be specified even if no change is 
necessary, or those not specified for the device 
type will be removed from the system. 

The model number is verified as n legitimate model number 
by searching the M.-MODNUM table, (See the SYSCON 
chapter in the CP-V/SM Reference Manual ; 90 16 74.) 
When found, its corresponding controller model number is 
obtained from the M.-MODNUM table. Thedevice/controller 
model numbers are then used to check If this combination is 
the same as that which was originally SYSGENed for the 
given device. If not the same, all similar device/ controller 
model number combinations in M:MODNUM are used for this 
validation. As an examp'e, if MrMOONUM contains the 
following entries: 



Device Modei 


Cor 


trolier Mode 


Number 




Number 


7120 




7120 


7120 




7121 


7121 




7121 


7121 




7120 



and the SYSGENed combination is 

7120 7121 



When :SAVE is not specified, all device addresses must be 
specified by :TYPE commands unless no : TYPE commands are 
used. Any SYSGENed devices for which addresses are not 
defined by :TYPE commands are removed from the system 
configuration (and cannot be returned to the system con- 
figuration without rebooting). 



then the command -.TYPE CR7121, .... will cause the fol- 
lowing device/controller combinations to be checked with 
the Indicated results: 



7121/7120 
7120/7120 
7121/7121 
7120/7121 



not valid 
not valid 
not valid 
valid 



:TYPE The :TYPE command defines a device type, its 

model number, and its new device address or addessses. The 
format of the command for single access device definitions 
is 

:TYPE device, value[, value], . . 

and the format for dual access device definitions is 

:TYPE device, (value., value_)[, (value., value-)]. . . 



device is a six character field. The first two char- 

acters specify the device type (e.g., CR) and the 
last four characters specify the device model num- 
ber in hexadecimal. 

value specifies the device address in the format de- 

scribed at the beginning of this section. The num- 
ber of addresses depends upon the number of devices 
of that device type whichare on the target machine 
or which need address changes (when :SAVE is 
used). For dual access devices, value] specifies 
the primary path address and value2 specifies the 



iREMOVE This command removes a device or controller 

from the system. The removed device or controller cannot 
be returned to the system without rebooting. The format of 
the command Is 



rREMOVEJ 



value 1 

CONT, value] 



where 



value specifies the address of the device or control- 
ler to be removed in the format described at the 
beginning of this section. 



CONT specifies that a controller is to be removed. 
When a controller is removed, all devices on that 
controller are also removed unless the controller is 
dual access. When the controller is dual access, 
only the path specified by value is removed unless 
the other path to the device is already removed or 
doesn't exist (i.e., single access within dual chan- 
nel). In the latter case, all of the controller's 
devices are also removed. 
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In the following example, four disk packs were SYSGENed 
and the target system is to have only two disk packs, one 
public and one private. 

:TYPF, DP7242,BF(i,BFl,BF2 
: REMOVE BF1 



SYSGENed 
Disk Packs 



Result of 
:TYPE Command 



AFO- public BFO - public 

AF1- public BF1 - public 

AF2 - private BF2 - private 

AF3 - private removed 



Result of 
:REMOVE Command 

BFO - public 
removed 
BF2 - private 
removed 



:PART The :PART command specifies a device or con- 
troller that is to be partitioned from the system. The device 
or controller is partitioned as if it had been partitioned by 
the SYSCON processor and can be returned to the system 
via SYSCON without re-booting the system. (Refer to the 
SYSCON processor description in the CP-V/SM Reference 
Manual, 90 16 74.) This is useful when a system is being 
booted and a device which was SYSGENed to be part of the 
system is currently unavailable but will be available prior 
to the next system boot. COCs and Teletypes are not af- 
fected by this partitioning. The format of the :PART com- 
mand is 



-.PART 



[value 1 

[CONT,value] 



where 

value 



specifies the address of the device or con- 
troller to be removed in the format described at 
the beginning of this section. 



CONT specifies that a controller is to be parti- 

tioned. When a controller is partitioned, all de- 
vices on that controller are also partitioned unless 
the controller is dual access. When the controller 
is dual access, only the path specified by value is 
partitioned unless the other path to the device Is 
already partitioned or doesn't exist (i.e., single 
access within dual channel). In the latter case, 
all of the controller's devices are also partitioned. 

A device partition request causes all devices which have 
identical device addresses to be partitioned. 



Example: 

A system was SYSGENed to have four 9-track tape drives 
but two are down for maintenance when the system is booted, 



TYPI- 9T71?2,ARO,A81 .A82.A83 
PART A82 
PART A81 



:END The :END command defines the end of the set of 

reconfiguration and partitioning commands. The command 
is optional because the occurrence of either the first nonrool 
patch or an asterisk (*) command would also Indicate the 
end of reconfiguration and partitioning commands. 

The format of the command is 



:END 



When the end of reconfiguration and partitioning commands 
is encountered, all :TYPE command definitions are pro- 
cessed first, then all : REMOVE requests, and finally all 
:PART requests. 

When all of the commands have been processed, a check is 
performed to determine if the original SYSGEN or the re- 
configuration for multi-unit controllers and their devices 
reside in non-conflicting input/output queueing channels. 
This means that an IOP/controller or cluster/unit in one 
queueing channel cannot have an equivalent IOP/controller 
or cluster/unit in some other queueing channel. The follow- 
ing error messages will identify ail such conflicts and the 
reconfiguration process will then change the queueing chan- 
nels to be equivalent: 



****QUEUEING CONFLICT BETWEEN DCTiiANDDCT jj 
QUEUE FOR DCTij CHANGED TO THAT OF DCTii 



where 

i? is the DCT index for the first device. 

jj is the DCT index for a subsequent device. 

RECONFIGURATION AND PARTITIONING EXAMPLE 

In the following example, a CP-V sysrem was SYSGENed 
for four different hardware configurations. These configura- 
tions are referred to as the 560X, 7T, 7D, and 7E. A set of 
reconfiguration and partitioning commands was generated for 
each machine with the set of commands for each machine 
being bounded by a conditional patch control command. 
The four sets of reconfiguration and partitioning commands 
exist in the patch deck. The one set that is to be used for 
a particular boot is selected by a set of conditional patch 
control commands such as the following: 

# 560X = 

#7T=0 

#7D = 1 

'7E-0 

The above commands indicate that the 7D machine is to be 
booted. Figure 7 lists the entire set of devices that were 
SYSGENed for this example. Figure 8 lists the set of recon- 
figuration and partitioning commands which were ignored 
because they were for machines not being booted. Figure 9 
lists the set of reconfiguration and partitioning commands 
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SYSGENED r«NFIflURATI8N 



DEVICE RESOURCE C8NFIGURATJ8N 
Dev-TYP I CEV-ID I DEV-ADDR |DCT«ClTt PUB/PRIV I TYPE I RT6T I GENERAL INF8RMATIBN 



TY7012 
CR7UO 
CP/16C 
Lp74^5 
lP7**5 
DC7212 
DC7212 
DC7232 
DC7232 
9T7322 
9T7322 
9T7323 
9T7323 
9T7323 
9T7323 
CP7242 
DP7242 
DP7242 
DP7242 
DP7271 
OP7271 
DP7271 
DP7271 
DP7271 
DP7271 
DP7271 
DP7271 
DP7271 
DP7271 
RBFFFF 
XP1200 
ME7611 
ME7611 



TyACl 

CRA03 
CPAC4 
LPAQ2 
lPAOF 
DCEFo 

DceFi 

OCCFO 
DCCFi 

9TA«o 

9TA81 
9TA82 
9TA83 
9TA84 
9TA85 
DPC80 
DPD81 
DPD82 
DPD83 
DPAEO 
DP*£1 
DPAE2 
CPAE3 
DPAE* 
DPAE5 
OPAE6 
OPAE7 
DPAFo 
OPAFl 
RBA16 
XPCOD 
MEAIO 
MEAU 



0001 

0003 
000* 
0002 
OOOF 
01FO 
OlPl 
02PO 
02F1 
00«0 
0081 
00«2 
0083 
008* 
0085 
0380 
0381 
0382 
0383 
QOEO 
OOEl 
00E2 
00E3 
00E4 
00E5 
00E6 
00E7 
OOPO 
OOEl 
0016 
020D 
0010 
0011 



01.01 
32-02 
03-03 
0*04 
05-05 
06-06 
07-06 
08-07 
09-07 
OA-08 

oB-oa 

OC-08 
OD-08 
OE-08 
OF-08 
10-09 
11-09 
12-09 
13-09 
14. OA 
15- OA 
16. OA 
17. OA 
18.QA 
19. OA 
1A-0A 
1B-0A 
ICOA 
10-OA 
1E-0B 
1F-0C 
20. OD 
21-OE 



TV 
CR 
CP 

LP 

DC 



9T 



PUB 

PUB 

PR IV 

PR IV 

PUB 

PUB 

PUB 

PUB 

PUB 

PUB 

PUB 

PUB 

PUB 

PUB 



DP 



06 



02 



N8T.RART I TAXABLE 

NB-PART-DEV fSYM 

SYH8I6NT 

NB-PART-DEV JSYM 

SYMBI8NT 

NeT-PARTITIONABLE 

N8T-PARTITI8NA8LE 

N6T-PARTITI8NA8LE 

N6T-PARTITI8NA3LE 

Ne-PART-CBNT 

N8-PART-C8NT 

N8-PART-C8NT 

N8-PART-C8NT 

N8.PART-C8NT 

N6-PART-C8NT 

N8T-PARTITI8NABLE 

N8T-PARTITI8NABLE 



RB 
XP 

ME 



N8-PART 

N8T-PART 

N8VPART 

N8T-PART 

N8T-PART 

N8T.PART 

N8T-PART 

NBT-PART 

N8T-PART 

N8T-PART 

NBT'PART 

N8-PART 

N8-PART- 

N8T-PART 

N8T»PART 



DEV 

ITI8NABLE 

ITI8NABLE 

ITI8NABLE 

ITI8NA8LE 

ITI8NABLE 

ITIBNA8LE 

ITIBNABLE 

ITI8NABLE 

ITIBNABLE 

ITIONABLE 

DEV 

C8NT ISYM 

ITIBNABLE 

ITIBNABLE 



Figure 7. Device Resource Configuration from SYSGEN 



... • ....... #7E 

M .......IMtlM.ttlMl SAVE 

• I TYPE RBFFFF* A 1 4 

.1 TYPE DCBFO 

IREMflVE A84 

• t IREMflVE A85 

• 1 TYPE DR7271* D90* 091 

, . , 1 TYPE DP7242* DflO'D81 

• ieNO 

» 

.*7T 

,.•.••..••...•.• I SAVE 

t • * • • IREMflVE C0NT*D8O 

t...lEND 



* • • t (KB60X 

• • t ......... IG8 

...... ••...•••••••••••••••••IFND 

» 



Figure 8. Reconfiguration and Partitioning Commands that were Ignored 
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which were used in the boot process because the 7D was 
selected. Figure 10 lists the set of devices for the 7D con- 
figuration. This information is listed on the line printer 
during a boot, but not necessarily in the order shown in the 
Figures. All of the information listed in Figures 7, 8, 9, 
and 10 is also entered into the system patch file. 

In Figures 7 and 10, DCT is the DCT index and CIT is the 
queueing channel's index. Also in these figures, when a 
device type (DEV-TYP) is a pooled device (i.e., dual ac- 
cess), the information for the alternate device is listed di- 
rectly below that for the primary device. The information 
is the same except that the DEV-TYP column contains 



the word "DUAL" and the DEV-ADR column contains the 
alternate device address. 



RECONFIGURATION AND PARTITIONING MESSAGES 

Table 5 lists the messages that may be output when recon- 
figuration and partitioning commands are being processed. 

When an error is encountered, the error message is preceded 
by a message containing a dollar sign ($) beneath the char- 
acter position in the command at which the error was found. 
Processing of the command in error is discontinued. 



*7D 

1SAVE 

«#KEEP ALL DEVtADCR.AS IS EXCEPT F8R ITYPE/IREM8VE CHANGES 

IREM8VE AOF 

IREM8VE A16 

ITYPE 9T7322,A80<A81 

ITYPE DC7212#BF0 

IREM8VE C8NT#AF0 

IREM8VE CFl 

IREM8VE C8NT*AE0 

ITYPE DP7242*D80 

ITYPE ME761WA05 

I END 



Figure 9. Reconfiguration and Partitioning Commands that were Used 
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DEV-TYP 


1 DEV.ID 


1 CEV-ADDR 


I0CT-CIT! 


PUB/PRIV 
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1 RT8T 1 


GENERAL INFBRMATIBN 


TY7012 
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0001 


01-01 




TY 




N8T-PARTITI8NABLE 


CR7140 


CRA03 


0003 


02-02 




CR 




N8-PART»DEV |SYM 


CP7160 


CPAO* 
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03-03 




CP 
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LP7445 


LPA02 


0002 


04-04 




LP 
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DC7212 


DCBFO 
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06-06 
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DP 
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controller has been removed. 













Figure 10. Device Resource Configuration for the Booted System 
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Table 5. Reconfiguration and Partitioning Messages 



Message 


Description 


ALL :TYPE/:REMOVE COMMANDS IGNORED 


A :GO command has been specified. :TYPE and :REMOVE 
commands are not meaningful. 


**dev ice, value CANNOT BE ADDED TO SYSTEM 


As the result of the :TYPE command, the SYSGENed system and 
target machine device/controller model number definitions are 
not equivalent. This message is preceded by a message containing 
a dollar sign ($) under the device type and also under the first 
device address for single access or the alternate device address 
for dual access devices. 




device - device type and model number. 




value - device address (in the format ndd described at the 
beginning of this section) . 




This message can also appear when there are more :TYPE defini- 
tions for the device type than allowed for in the SYSGENed 
system . 


CANNOT CONVERT 'n* IN 'yyndd' 


A device address was encountered for which the n in yyndd could 
not be validated. 


CANNOT PARTITION, CONT. ndd ALREADY 
PARTITIONED 


The controller specified on a :PART command has already been 
partitioned. 


CANNOT PARTITION, CONT. ndd NON- 
PARTITIONABLE 


The controller specified on a :PART command is not partitionable. 
(It is a controller for a Teletype, a RAD, or a COC, or it was 
defined at SYSGEN to be a non-partitionable controller.) 


CANNOT PARTITION, CONT. ndd NOT 
PRESENT 


The controller specified on a :PART command either does not exist 
or was removed in the reconfiguration process. 


CANNOT PARTITION, CONT. ndd NOT 
PRIVATE PACK 


A disk pack controller was specified on a :PART command and one 
or more of its associated disk pack spindles is public. Public disk 
pack spindles cannot be partitioned. 


CANNOT PARTITION, DEV. ndd ALREADY 
PARTITIONED 


The device specified on a :PART command has already been 
partitioned. 


CANNOT PARTITION, DEV. ndd NON- 
PARTITIONABLE 


The device specified on a :PART command is not partitionable. 
(It is either a Teletype, a RAD, or a COC, or it was defined at 
SYSGEN to be a non-partitionable device.) 


CANNOT PARTITION, DEV. ndd NOT PRESENT 


The device specified on a :PART command either doesn't exist or 
was removed in the reconfiguration process. 


CANNOT PARTITION, DEV. ndd NOT PRIVATE 
PACK 


Public disk pack spindles cannot be partitioned. 


CANNOT REMOVE, CONT. ndd NOT PRESENT 


The controller specified on a -.REMOVE command either does not 
exist or was previously removed in the reconfiguration process. 


CANNOT REMOVE, DEV. ndd NOT PRESENT 


The device specified on a :REMOVE command either does not 
exist or was previously removed in the reconfiguration process. 


CONT. ndd PARTITIONED 


The specified controller has been successfully partitioned. 
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Table 5. Reconfiguration and Partitioning Messages (cont.) 



Message 



Description 



CONTINUATION ILLEGAL 



DEV. ndd PARTITIONED 



DUAL ACCESS DEFINED ILLEGAL nddj, ndd 2 



DUAL/SINGLE ACCESS MIXTURE 



INVALID TERMINATOR 



**KEEP ALL DEV. ADDR. AS IS EXCEPT FOR 
:TYPE/:REMOVE CHANGES 



NO RECONFIGURATION PERFORMED DUAL 

ACCESS DEFINITION CONFLICTS 
(ndd 1 [ / ndd 2 ]) / (ndd 3 [ / ndd 4 ]) 



**NO SPACE LEFT FOR CONFIG. INFO 



**PACK yyndd PARTITIONED, DIAL ndd 
NOT AVAILABLE 



**QUEUEING CONFLICT BETWEEN DCT ii 
AND DCT j] 

QUEUE FOR DCT j] CHANGED TO THAT OF 
OF DCT ii 



Continuation commands (i.e., commands containing a semicolon) 
are not allowed. 



The specified device has been successfully partitioned. 



On a :TYPE command, the primary address and the alternate ad- 
dress on a dual access device are equivalent. 



A :TYPE command specifies both single access and dual access 
device addresses; or the device type is for a single access device 
and the address is for a dual access device (or vice versa). 



A bad or unknown terminator terminates a field or option. Valid 
control command terminators are NEW LINE, period, carriage 
return, trailing blank, and end of control command image. 



A :SAVE command has been encountered. 



The :GO command was specified, or no : commands were spec- 
ified, or a :END command was specified by itself. 



A device address conflict has occurred as the result of :TYPE 
commands. Either a single access device address is the same 
as a primary or alternate address on a dual access device, or 
the primary address is the same as the alternate address on a 
dual access device. The ndds indicate the addresses involved. 
This message will appear twice for each conflict encountered. 

Too many :TYPE, :REMOVE, and :PART command definitions 
have been encountered. The total size of the internal buffer 
which retains reconfiguration and partitioning commands is 
512 words. Each :PART and :REMOVE command requires one 
word, each :TYPE command for single access controllers requires 
two words, and each :TYPE command for dual access requires 
three words. Additionally, the buffer contains one control word, 
The buffer is needed to retain all control command information 
until every command has been processed. Actual processing of 
the commands takes place when the :END command, the first non- 
root patch, or an asterisk command is encountered. 



The device specified on a :PART command is a disk pack spindle. 



An IOP/controller or cluster/unit in one queueing channel has an 
equivalent IOP/controller or cluster/unit in some other queueing 
channel . The reconfiguration process will change the queueing 
channels to be equivalent. 
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Table 5. Reconfiguration and Partitioning Messages (cont.) 



Message 


Description 


**TAPE yyndd PARTITIONED, DIAL ndd 
NOT AVAILABLE 

UNKNOWN COMMAND, FIELD, OR VALUE 


The device specified on a :PART command is a tape drive. 

An unknown command, an invalid name, or a value field which 
contains too many characters, is not hexadecimal, or is not in 
the correct format for the particular machine was encountered. 
This message also appears for each reconfiguration and partition- 
ing command encountered after reconfiguration and partitioning 
processing has ended. It also appears when a :GO, :REMOVE, 
or :TYPE command is encountered after a :GO command has 
been processed and when a :SAVE command is encountered after 
a previous :SAVE command was processed. 



IGENDCB COMMAND 

This command defines the system DCB associated with tape 
input during PASSO. This command is required only if the 
files are on a different tape than the boot tape or if they 
occupy more than one reel. If the command is not present 
in the patch deck, PASSO reads the account and serial num- 
ber from the tape and performs an automatic premount of 
the tape. No operator intervention is required. 

The format of the :GENDCB command is: 

:GEN DCB (M : BI , account[, password]; 
:, (INSN,value[, value]... ),device) 



Example: 

:GENDCB (M:BI,ACCT1,PASSI,; 

:(INSN,001,002),9T) 

Any number of GENDCB commands may appear in the patch 
deck. Only the last will be applied. If it is defective, 
files will be copied from the boot tape. 

Any errors in the command are indicated by the message 

***GENDCB ERROR 

on the OC and LL devices. 



wh« 



M:BI specifies that tape input is to be through the 
M:BI DCB. No other DCB is valid for this 
command. 



account specifies an account identifier (up to eight 
alphanumeric characters) associated with the la- 
beled tape to be read during PASSO. 



password is the password associated with the labeled 
tape to be read during PASSO. The password (if 
any) must correspond to that specified when the 
tape was created, and may be up to eight alpha- 
numeric characters in length. 

INSN, value, ... specifies the serial number(s) (up 

to four alphanumeric characters in length) of the 
tape(s) to be read by PASSO. No more than three 
reels may be specified. The first reel specified 
must contain the first file to be read, and may be 
different from the reel used to boot the monitor. 



GENMD COMMANDS 

The GENMD commands are used in conjunction with the 
GENMD patches described below. The three GENMD com- 
mands are GENMD, LIST, and DELETE. 



GENMD This command indicates which file is to be 

patched next. A GENMD command must precede the set 
of patches for each file to be patched. Any number of sets 
of patches to the same file may be present, provided each 
is preceded by a GENMD command. The format of the 
command is 

GENMD filename 



LIST This command lists the patches currently in the file 
being patched and has the format: 



LIST 



device specifies a tape-type device code (e.g., 
9T, 71). 



DELETE When a file is patched, a record is kept of the 
list of patches to the file within the file itself. The DELETE 
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command removes tim list ai patches from the file (but does 
not remove the effect of the patches on the file). The com- 
mand may be used to prevent files from growing too large if 
they are not restored when applying a new patch deck. The 
format of the command is 

DELETE 



GENMD PATCHES 

GENMD patches are used to modify nonresident elements of 
the system. 

GENMD patches have the format: 

: GENMD r.segnamel . . r , -, r .-, 

r -I loc, value Lvalue!. . .1. comment 

[segnamej, l j l j 



Old value is formatted in the same manner as 
value. If the old value specified is not the same 
as the actual old value, an error message will 
be issued. However, if the old value specified 
matches the (new) value specified, the message will 
be issued but the error will not be counted and pro- 
cessing of the patch will continue. 

A GENMD command may be continued by terminating the 
first line with a semicolon (;). The semicolon must not di- 
vide a name or a hexadecimal string and is not permitted 
where a blank is required. The continuation line must be- 
gin with a colon (:) if the continued line began with 
:GENMD. Otherwise, the continuation line begins with 
the next character of the command . 



segname specifies the overlay segment name to be 
patched. If not present, the most recently spec- 
ified segname is assumed. If not present and no 
segname was specified previously, the root seg- 
name is assumed. 



GENMD ERROR MESSAGES 

Table 6 lists the error messages that may be output when 
GENMD commands and patches are being processed. 



loc specifies the location to be patched and has the 
format [name] [±hex value]. The hexadecimal 
value is added to or subtracted from the absolute 
address of name. A maximum of eight characters 
may be used for the hexadecimal value. The name 
need not be defined in any particular overlay since 
all the stacks are searched. If more than one 
overlay defines the same name, the first is used. 
The special name & refers to the start address word 
in the load module HEAD record. 

value specifies the value to be inserted at loc. If 
more than one value is specified, they will be in- 
serted at successive locations. Each value must 
have the format 

hex value[±name[±name]. . .] 

The absolute address of the names are added to or 
subtracted from the hexadecimal value. A max- 
imum of eight characters may be used for the hexa- 
decimal value. The name need not be defined in 
any particular overlay since all the stacks are 
searched. If more than one overlay defines the 
same name, the first is used. 

If a name needs to be referred to with other than 
word resolution, the standard format is permitted 
for byte, halfword, and doubleword resolution 
(e.g., BA(name)). 

Any value specification may optionally contain a 
replacement value check specification using the 
format 

value (old value) 



CONDITIONAL PATCH CONTROL COMMANDS 

A conditional patch control command specifies whether the 
patches that follow are to be used as patches or are to be 
effectively ignored. The conditional patch control com- 
mand controls the SKIP flag. When the SKIP flag is set, 
all subsequent patches are effectively ignored until the 
SKIP flag is reset. The conditional patch control command 
can appear any number of times and anywhere within the 
patch deck (including the GENMD portion). The command 
has the format: 

"Lvalue] 

where value is any well-formed, but not necessarily evalu- 
atable, expression terminated by a blank. The value expres- 
sion may contain an undefined symbol. 



If value contains an undefined symbol, is negative, or is 
zero, the SKIP flag is set. While the SKIP flag is set, only 
the segname field of a patch is examined to determine when 
the current segment's patches end. If value is absent or 
greater than zero, the SKIP flag is reset and normal patch- 
ing resumes. The special symbol ELSE may be used to toggle 
the setting of the SKIP flag. 



The SKIP flag is also changed when a Delta format patch 
that does not have a loc and value field is encountered 
(i.e., segname//). In this case, it is set if the segname is 
undefined and it is reset otherwise. 
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Table 6. GENMD Error Messages 



Message 


Description 


BAD LMN - 0000 


The file is nor a load module. 


BAD LMN - xxxx 


An error occurred when accessing the load module. The code and 
subcode are indi cared by xxxx. 


BAD SEG 


A segname is nor in the TREE. 


DLM AT xx 


The delimiter in column xx is not what it should be. 


**nn GENMD ERRORS DETECTED 


This message is output on the OC and LL devices at the conclusion 
of the GENMD patching process and indicates how many errors 
occurred . 


HEX AT xx 


The hexadecimal number ending in column xx is null, too large, or 
not hexadecimal. 


LOC AT xx 


The location ending in column xx or whose value ends in column xx 
is not contained in the segment. 


NAME AT xx 


The name ending in column xx is null or is not in the load module's 
stacks. 


NO FILE NAMED 


A 'GENMD filename' command has not yet been encountered or has 




no filename on it. 


OLD + loc = value 


A replacement check error has occurred. That is, an 'old value' was 
specified which did not match the actual old value. The loc field 
specifies the location where the error occurred. The value field 
specifies what the actual old value in the location was. 


TOO BIG 


Not enough core is available to read the REF/DEF stack. It may be 
possible to do the patch if all names are converted to absolute hex- 
adecimal values, since the stacks are read only if a name is used. 
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Examples: 



PATCH FILE CREATION 



1. The following patches will be included only if the sys- 
tem was generated for a large Sigma 9 or a large 
Xerox 560. 

# : BIG 

/SWAPPER+.C5/B (3/ 
/(a/Ll,5 0/ 
/@/SLS,7 LI/ 
/@/B SWAPPER+.C6/ 
# 

2. The following patches will be included only if the 
ENQ/DEQ feature was included in the system: 

ENQ// 

ENQ/ENQ0+.266/B @(CW,13 ENQP+.1F4)/ 

/@/LB,15 ENQP+.1F4/ 

/@/CB,15 13/ 

/@/B ENQ0+.256/ 

OPEN// 

3. The symbol BPS will be set to one if the system was 
generated for a pack swapper with greater than 128K. 
Otherwise, it will be set to zero. 

#:BIG*DPSI0 

#BPS=1 

#ELSE 

#BPS=0 

# 



All patches read during the startup of the system (except 
GENDCB commands) are copied to the file PATCH in the 
system account. Those that were read while the skip flag 
was set appear with the word SKIP in columns 77-80. The 
resulting file may be used as input to DEF to create a sys- 
tem tape with the complete, current patch deck on it. 



SEQUENCE OF OPERATIONS 

The master system tape is loaded into the machine by use of 
the standard load procedure described in the CP-V/OPS 
Reference Manual, 90 16 75. The hardware bootstrap loads 
and enters the tape boot at the beginning of the system tape. 
This tape boot, in turn, loads the monitor root and the fol- 
lowing functions are then performed. 

If the system was generated with the BIG option on the 
:MON card and is not being booted on a Sigma 9 or Xerox 
560, the following message is output to the operator's con- 
sole and the bootstrap operation is terminated. 



SYSTEM REQUIRES SIG9 OR X560 



The operator's console (OC) device address is validated. If 
the actual OC device address is different than that of the 
SYSGENed address, the system will halt (wait). The oper- 
ator should enter the appropriate OC address into register 0. 



To enter the OC address on a Sigma machine: 
1 . Put the machine in IDLE. 



2. Set the SELECT ADDRESS switches on the control panel 
to 0. 



COMMENT CARDS 

Comment cards may appear anywhere within the patch deck. 
In the portion of the deck that contains Delta format patches 
and symbol definition patches, the comment card must con- 
tain a Mess than' character (<) in column one. In the 
GENDCB and GENMD portion of the deck, comment cards 
must contain one of the following in column one: 



3. Enter the appropriate device address into the SELECTed 
ADDRESS. 



4. Set the COMPUTE switch to the RUN position. 

To enter the OC address on the Xerox 560: 
1. Enter CONTROL P. 



2. Enter 0/ (which displays the contents of register 0) . 
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3. Enter the new device address followed by the letter M. 

4. Enter an X. (This will cause the 560 to resume processing.) 

After the OC address has been validated, the following 
message is output to the operator: 



ENTER ANY OF: 


I 


= TTY I/O 


P 


= LP OUTPUT 


F 


= TAPE FILES 


S 


= :SYS FILES 


T 


= TAPE PATCHES 


C 


= CARD PATCHES 


D 


= X DELTA 



The operator must respond within 10 seconds by typing one 
or more of the characters above followed by new line or by 
entering new line alone. If new line alone or nothing is 
entered, T is assumed by default. If any characters other 
than those listed above are entered, they are ignored. 

The letters have the following meanings: 

I specifies that the operator wants to read and re- 

spond to the normal OC messages during the boot. 
Otherwise, default responses are assumed up to 
the date/time request (see below) and normal 
output is suppressed. (Error messages will still 
be output. ) 

P causes output to the LL device to occur. Other- 

wise, the printer is not used. 

F causes PASSO's tape copy operation to occur. 

Otherwise, a boot-under-the-files occurs. 

S causes the files to be copied from the POtape into 

:SYS without destroying the entire file system. 

T define that the patch deck(s) are to come from 

and tape or cards respectively. Either, neither, or 
C both may be specified. If both are specified, 

cards will be read first for root patches and last 
for overlay patches and GENMD commands. 
Card patches meant to repatch tape root patches 
should therefore be placed aftera nonroot patch. 
Patches of the format segname// should be used 
in both patch decks to prevent the switching of 
devices from splitting up a logical patch. 

D causes Executive Delta to be retained after the 

boot for debugging purposes. 

N is meaningful only by itself and means "none of 

the above" . 

The message 



NEW FILE SYSTEM 



indicates that F was specified. If F was specified, the old 
file system is not destroyed until the entire patch deck has 
been read. The bootstrap operation may be halted at any 
time during this interval by triggering a console interrupt. 
The message 



INITIALIZATION HALTED - RESTART O. K. 



indicates a successful halt. 

If I was specified and if the system includes the real-time 
option, the system then issues the following message. 



RESET RESDF YYY,XXXXX 



This message allows the operator to override the SYSGEN- 
defined values for the size of the RESDF area (dedicated 
real-time memory pages) and its starting address. The op- 
erator should respond: 



[yyy] I>xxxx] © 



where 

yyy is the optional decimal number of pages to be 

in the RESDF area; a value of through 999 may 
be used. 

xxxxx is the optional hexadecimal word address of 

the first page to be in the RESDF area. Any page 
address representing a value greater than or equal 
to 10,000j 6 (64K) may be used. 

If either or both optional parameters) are not specified, the 
SYSGEN-defined default(s) will be used. 



CP-V will then request the date 



DATE (MM/DD/YY) = 



and the operator should enter the date (e.g., 2/5/74). 
Then CP-V will request the time 



TIME (HH-.MM) 



and the operator should type the time, which is represented 
by a 24-hour clock (e.g., 6:05 PM is typed as 18:05). The 
time of day is typed at the left margin of the console once 
every minute after the system has been initialized. The 
form of this type-out is 



hh:r 



If the system is being loaded on a machine for which it was 
not SYS GE Ned, one of the following messages will be dis- 
played on the OC device and the bootstrap operation will 
be terminated. 
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SYSTEM NOT SYSGENED FOR SIGMA 6 



SYSTEM NOT SYSGENED FOR SIGMA 9 



SYSTEM NOT SYSGENED FOR XEROX 560 



If the system and target machines match and if I was speci- 
fied the following message is displayed: 



C/LL/DC ASSIGN OK (YES/NO) 



If the operator's response is YES or ©, it is assumed that 
the device addresses for the control device, listing log, 
and system device are not to be changed from those estab- 
lished when the monitor was defined. If the response is 
NO, then the following messages will be output to rede- 
fine these device addresses. 



CRndd => CR 




LPndd =£■ LP 




DCndd =5> DC 



where each ndd is the current device identification and as 
many DC messages are output as there are swap devices. 

In response to each of these messages the operator must type 
two or three characters. If two characters are typed, they 
must be 'SA' and indicate no change for this device. If 
three characters are typed, they must be the channel and 
device designation codes (ndd) defining the address of the 
indicated device (see Appendix B, Tables B-2 and B-3). 

If the DC or swapper assignment is incorrect, one of the fol- 
lowing three messages will be displayed. Two of the mes- 
sages request a new swapper device address. 



Hyyndd INOPERATIVE 
yyndd => yy 



(The device address is unrecognizable by the hardware.) 



! ! yyndd NOT A dddd 
yyndd 4>yy 



(The dddd field specifies the model number that was expected 
as the swap device.) 



PSA TRACK FLAWED 



(The swapper disk pack contains flaws. The boot process 
terminates.) 

Before completing any of the above responses with a © or 
©, the operator may cancel the response by striking the© 
key. Following this, or if a completed response is in error, 
the message 



oo 



will be output and the key-in request will be repeated. 



If no characters are typed within 10 seconds, a © response 
is assumed. 

After all necessary responses have been received, the boot 
subroutine reads the system information record from tape 
and writes it on the LL and OC devices if Pand I are speci- 
fied, respectively. 

The following sense switch information is then listed on the 
OC device if I was specified. 



SET SENSE SWITCHES AND TYPE N/L 

SSW1 =>CHECKWRITE DISK WRITES 

SSW2 =>NO AUTOMATIC LOGON/LOGOFF 

SSW3 =>OPERATOR RECOVERY ON DISK BOOT 

SSW4 =>SYSTEM SECURITY CHECKING 



The system will continue when a NEW LINE or any other 
character is entered. 

Next, the reconfiguration and partitioning commands (if 
any exist) are read and processed. A summary of the 
system's device will be output on the LL device (even if 
no :TYPE commands are encountered). Permanently down 
devices are not listed. 

Next, the monitor patches are read and processed for the 
patching of the overlays, ALLOCAT, GHOST 1, and 
RECOVER. (If the RECNFIG boot-time processor needs to 
be patched, XDELTA performs the patching as it does for 
the monitor root. However, these patches must precede 
the reconfiguration and partitioning commands in the patch 
deck. ) 

After the nonroot patches have begun, reconfiguration and 
partitioning commands are illegal. If any such commands 
appear in the deck, the following message is displayed on 
the OC device (and also on the LL device if P was speci- 
fied) and the bootstrap continues. 



':' COMMAND NOT IN PATCH DECK PROPERLY 



This message is displayed only one time, even if additional 
reconfiguration and partitioning commands are encountered. 
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If then copies the overlays, etc., to the swapping device, 
communicating the sizes and disk addresses to the resident 
root of the absolute monitor. Control then passes to another 
boot subroutine at WRTROOT. This second boot subroutine 
causes the monitor root to be copied to the disk, preceded 
by a disk bootstrap. At this point, the resident monitor is 
operational but the system has not yet been established on 
the resident swapping device. The GHOST! processor 
performs this function. 

If P was specified, GHOST1 determines whether any de- 
vices or controllers are partitioned. If none are partitioned, 
the following message is displayed on the LL device: 



*** NOTHING PARTITIONED 



However, if devices and/or controllers are partitioned, 
the following message is displayed on the LL device: 



***** ITEMS PARTITIONED ***** 



followed by messages identifying each device or controller 
which is partitioned. The messages have the following 
formats: 



The hardware boot routine loads and transfers control to the 
disk boot which then loads the monitor root into core. The 
system requests the date and time and then asks 



DO YOU WANT DELTA (Y/N)? 



to determine whether the system debugger's memory should 
be released. 

The following message is then output to the operator's 
console: 



DO YOU WANT HGP RECONSTRUCTION (Y/N)? 



A response of Y causes an HGP reconstruction of the public 
file system to be performed. If no response is received 
within one minute, N is assumed. 

Partitioning information is displayed as described previously, 
and the system ghost jobs (Fill, ERR:FIL, and Fix) are 
started. Normal operation may then be resumed. 



DEV yyndd PARTITIONED 



(for devices) 



CONT yyndd PARTITIONED 



(for controllers) 

When all partitioned items have been identified, the 
following message concludes the list: 



<* END OF PARTITIONED ITEMS 



When P was not specified or when GHOST1 has completed 
the above listing, GHOST 1 starts the symbiont ghost, Fix 
ghost, ERR:FIL ghost, and fill ghost, and then exits. 



BOOTSTRAP I/O ERROR RECOVERY 

I/O error recovery during bootstrap is provided for the card 
reader, line printer, magnetic tape, and disk. However, 
error recovery is not possible until the tape boot and mon- 
itor root have been read from tape. The following error 
messages may appear on the OC device: 



! lyyndd INOPERATIVE 



! lyyndd ERROR. TIO value, TDV value, 
CMD=loc 



! lyyndd CKWRT ERROR, TIO=value, TDV=value, 
CMD=loc 



! lyyndd WRITE PROTECTED, SEEK^alue 



! lyyndd MANUAL MODE 



BOOTING FROM DISK 

Once the operating system has been bootstrapped from tape, 
it may thereafter be brought into core from the disk by 
means of the load procedure described in the CP-V/OPS 
Reference Manual, 90 16 75. 



where 

yyndd 
value 



CHECKWRITE ERROR 



is the address of the device with trouble, 
indicates the TIO or TDV results or the SEEK 



address . 
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When any of the first four messages above occurs, the wait 
state is entered. To continue, the operator must place the 
CPU into IDLE, STEP, and then RUN state. The I/O will 
then be retried. If the last message above occurs, I/O will 
continue when the condition is corrected. When an error 
occurs for a magnetic tape or disk operation, the operation 
is retried ten times before an error message is output. 



PASSO reads a tape specified by the user (via the GENDCB 
command) which contains the nonresident elements of the 
system (i.e., CCI, processors, libraries, etc.). (This is nor- 
mally the labeled portion of the tape used to bootstrap the 
absolute monitor.) PASSO allows the user to modify these 
elements via the GENMD portion of the deck. 



PASSO PROCESSOR 

The PASSO processor performs various system initialization 
functions and is entered automatically whenever a CP-V 
tape is booted. 



PASSO MESSAGES 

The messages in Table 7 may be output by the PASSO 
program on the LL device. PASSO continues its normal 
operation. 



Table 7. PASSO Messages 



Message 


Description 


***CANNOT BOOT LMN 


A load module cannot be read from the bootstrap tape because 
core is not large enough. PASSO outputs the filename in error 
and continues to the next file, thus ignoring the file in error. 


I/O ERR/ABN nn,xxxING FILE ffffffff ON dddd 


An I/O error or abnormal condition has occurred on tape or 
disk. 

nn is the error or abnormal code. 

xxx is READ, WRITE, OPEN, or CLOS. 

ffffffff is the current filename. 

dddd is TAPE or DISC. 

PASSO continues after this message. 



PASSO Processor 
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4. MONITOR DUMP ANALYSIS PROGRAM 



INTRODUCTION 

The monitor dump analysis program ANLZ (Analyze) is 
designed to aid in the debugging of CP-V crash dumps. 
ANLZ operates in the ghost, on-line, and batch modes. 
It accepts as input any tape or disk dump produced by the 
recovery procedure and any tape dump produced by exe- 
cutive Delta. If a tape is input, the ANLZ user must sup- 
ply the tape type in response to the message 



ENTER TAPE TYPE: 71, 91, BT, ETC.. 



Tape input results in the creation of adisk file (CP5DUMP); 
subsequent tape inputs replace the contents of this file. 



GHOST MODE 

ANLZ is called automatically by the recovery procedure, 
and functions as a ghost job to interpret and summarize crit- 
ical monitor tables and to dump the monitor's dynamic data 
area. When ANLZ is initiated after a system crash, it 
neither looks for nor accepts any commands, operating en- 
tirely on default options. It assumes an INPUT command 
option of LAST; if unable to open the last MONDMP file, 
it then assumes an INPUT command of TAPE. (Refer to the 
description of the INPUT command in the following text.) 
When Analyze is run in this manner, the output is an ab- 
breviated form of the output produced by the ALL display 
command. 

ANLZ is also automatically initiated after a single user 
abort. In this case, it functions just as though it had been 
initiated as a ghost job via an operator key-in. (This is 
described below. ) 

ANLZ may be called as a ghost job by the operator to 
examine the tape produced during an irrecoverable crash. 
The operator key- in used for this purpose is 

GJ OB ANLZ 

ANLZ then asks the operator for a command: 



ANLZ: ENTER COMMAND, N/L SAYS TO DO ALL 



The operator may respond with one of the following 
commands: • 

NO - just exit. 

TA - read a recovery-built tape. 

ME - run interactively from the operator's console. 



CP - read the CP5DUMP file. 

1-7 - read the indicated MONDMP file. 

? - list the ANLZ commands on the line printer. 

N/L (new line alone) - do default ghost run. 

In the interactive ghost mode, a key-in of 

INT, id 

will cause termination of the current ANLZ operation and 
a prompt for input, (id specifies the ANLZ user's number. ) 

BATCH AND ON-LINE MODES 

Any batch or on-line user may call ANLZ by specifying 
the name of the program. For on-line users, this program 
name is entered in response to a TEL prompt for com- 
mands, as follows: 

IANLZ © 



Any user, in batch or in on-line mode, must have the proper 
privilege level (80 or better) to examine the monitor. If 
not, ANLZ outputs the following message 



xx PRIVILEGE LEVEL NOT HIGH ENOUGH 



where xx is the user's current privilege level. (Response 
messages are output on the line printer for a batch user.) 

When accessed on-line, as an interactive ghost, or as a 
batch job, ANLZ is completely command-driven. It re- 
sponds to commands that selectivelydisplay monitor tables, 
examine memory, and compare the dump with the running 
monitor. 

An on-line user may terminate a display by depressing the 
BREAK key. 

COMMANDS 



When ANLZ is first entered, it responds 



ANALYZE HERE 



and, if in on-line mode, it requests entry of an input com- 
mand with the prompt character 
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All commands, options, and output are identical for batch, 
interactive ghost, and on-line modes. 



INPU1 COMMAND 

INPUT The INPUT command directs ANLZ to input 

from a particular disk or tape file, or to open a file. The 
format of the command is 

IN[PUT]option 

where option may be any one of the options shown in 
Table 8. 

After reading a tape or disk file as directed by the INPUT 
command, ANLZ informs the user of the size of the file 
with the following message: 



THE LAST PHYSICAL PAGE IN THE FILE IS xx 



If in on-line mode, it then prompts (<) for the next command. 



Table 8. INPUT Command Options 



Option 


Meaning 


TA[PE] 


Directs ANLZ to read a tape created 
by the recovery process and to write it 
into the file CP5DUMP which is then 
used for input. 


CP[5DUMP] 


Directs ANLZ to open the CP5DUMP 
for input. 


la[st] 


Directs ANLZ to open the last file 
formed by the recovery procedure for 
input. (ANLZ must look at the run- 
ning monitor to obtain this information.) 


number 


Directs ANLZ to open a crash file 
formed by recovery. Recovery file 
names are of the form 

MONDMP(number) 

where number is the number of the dump 
file(l for the first dump since a "cold" 
start, 2 for the second, and so on). 



DISPLAY COMMANDS 

Three display commands may be used to output information 
from crash dumps. They are 

DISPLAY 



RUN 
ALL 



DISPLAY The DISPLAY command outputs information 

existing at the time of the crash. The format of the com- 
mand is 

DISPLAY] option 

where option specifies the information to be displayed 
(Table 9). 



RUN the RUN command outputs various linked lists of 

the monitor by running through the list and displaying each 
entry. The format of the RUN command is 

RU[N] option 

where option specifies the list to be printed (Table 10). 



ALL The ALL command performs all of the functions of 
the display commands described above and the functions of 
ANLZ (except dumps) when it is initiated by the auto- 
matic recovery procedure. The format of the command Is 

AL[L] 

A numerically and alphanumerically sorted monitor map is 
output at the end of the ALL display. 



INTERACTIVE MONITOR DISPLAY COMMANDS 

Commands in this group allow the user to examine either 
the dump or the running monitor. Both the monitor and 
user JIT and physical core may be examined. The com- 
mands are 



loc |, I0C2 

Line feed (or carriage return) 

t 

* 

MONITOR 
loc value 



loc The loc command outputs the contents of the speci- 

fied location. The format of the command is 



where loc is one hexadecimal value (1 to 8 hexadecimal 
digits) or two hexadecimal values separated by an operator 
indicating addition (+), subtraction (-), multiplication (*), 
or division (%). Note that loc values do not require a pre- 
ceding delimiter character ". ". 



Commands 
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Table 9. DISPLAY Command Options 



Option 



Meaning 



A J [ITS] 



Displays JIT, AJIT, and context area of all incore users at the time of the crash. 



AT[ABLES] 
AV[R] 



Displays the incore portion of ALLYCAT's tables. 



Displays the tape and disk tables. 



CI [TS][, index].. 



Displays the requested entries of the Channel Information Table. Up to 20 entry 
indexes may be specified. If no index is specified, the entire Channel Informa- 
tion Table is displayed. 



CO[C][, index] 



cu[n] 



Displays the requested entries of the COC table. Up to 20 entry indexes may be 
bwecified. If no index is specified, the entire COC table is displayed. 



Displays the current user's JIT, AJIT, and context area. 



DC[Tj[,indexj . . 



Displays the requested entries of the Device Control Table. Up to 20 entry indexes 
may be specified. If no index is specified, the entire Device Control Table is dis- 
played. 



EL[OG] 

FM[, index] . . . 



Displays and validates the incore error log buffers. 



FQ 

IO(, chan]. . 



Displays the requested entries of the file management read-ahead tables. Up to 
20 entry indexes may be specified. If no index is specified, the entire set of file 
management read-ahead tables are displayed. 



Displays the Free I/O Queueing tables. 



Displays the device on the requested I/O channel. Up to 20 channels may be 
specified. If no channel is specified, the devices for all channels are displayed. 



1Q [, index]. . . 
JIT[, id][,locl,loc2] 



Displays the requested entries of the I/O queueing tables. Up to 20 entry indexes 
may be specified. If no entry index Is specified, the entire set of I/O queueing 
tables are displayed. 



Displays the contents of the JIT for the user specified by id. Loci and |oc2 specify 
that only a portion of the JIT page is desired and represent a relative offset into the 
page in hexadecimal. If an id of is given or if no id is specified, the monitor's 
JIT is displayed. 



MR[,locl,loc2] 



Displays the requested portion of the monitor's root. The displacements (loci and 
loc2) must be absolute hexadecimal addresses. If no displacements ore given, only 
the monitor's data area will be dumped. 



OJ[lT] 



Displays all of the out of core JITs at the time of the crash. 



OS 



Displays the user outswap tables (if outswap is in progress). 



PA[RTITIONS][, index] 



Displays the requested entries of the partition tables. Up to 20 entry indexes may 
be specified. If no index is specified, the entire partition table is displayed. 



pf[ile] 



Displays the patch file that was created last. 



PM 



Displays the contents of the page matrix identifying the owners of all pages. This 
option assumes that page identifying routines (such as RUN USERS, KUN PROCS) 
have been run previously. 



PN 



Displays the processor inswap tables (if inswap is in progress). 
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Table 9. DISPLAY Command Options (cont. ) 



Option 


Meaning 


PP / pageno[, !ocl,loc2] 


Displays the contents of the indicated physical page. Loci and loc2 are relative 
page offsets expressed in decimal (0-512). If they are specified, only the portion 
of the page in the indicated range is displayed. 


RA[T] 


Displays the resource allocation tables. 


RB[T] 


Displays the remote batch tables (if there are any). 


registers] 


Displays the software check code, software check message, and the first two 
register blocks at the time of the crash. 


rc[xt] 


Displays the area of memory occupied by the recovery routines. 


RQ 


Displays the resource subqueue lists. 


st[able] 


Displays the output symbiont tables. 


sw[apper] 


Displays the contents of the swap/swap scheduling tables. 


sy[mbiont] 


Displays the contents of the RBBAT recovery file. 


TP 


Displays the transaction processing tables (if there are any). 


tr[aps] 


Displays the contents of the trap and interrupt locations. 


TS[TACK][,id] 


Dumps the temp stack of the user indicated by id. If no id is specified, the 
monitor's temp stack is dumped. 


US[ER][;d]... 


Displays the user tables of the specified users. Up to 20 users may be specified. 


VP, pageno[, loci, loc2] 


Displays the contents of the specified virtual page. Loci and loc2 are relative 
page offsets expressed in decimal (0-512). If they are specified, only the portion 
of the page in the indicated range is displayed. 


WHY 


Displays the software check code and the software check message. 



Table 10. RUN Command Options 



Option 


Meaning 


mo[nitor] 


Specifies monitor pages. 


pr[ocessor] 


"| S 1 
' InameJ 




Specifies processor pages or specific processor. The default is S, indicating all 
processor pages. 


RT 


Specifies real-time page chains. 


ST[ATE][,{ q S ,}] 


Specifies state queues. The number of a specific state queue may be specified 
(q^), or S indicates all. The default is S. 


"H&fcQ-J 




Specifies user pages for all users (S), or for particular users (id). Up to 20 users 
may be specified. The default is S. 


XD[ELTA] 


Specifies XDELTA's page chains. 
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lOfrJOCo This command outputs the contents of the 

memory locations between loc] and loc2» The format of 
the command is 

loc j, I0C2 

where locr is a hexadecimal number or an expression indi- 
cating a sum or difference of two hexadecimal numbers. 

Two levels of loc; commands may be joined by the +, -, *, 
and % (division) operators. For example, the following are 
permissible: 

loc + loc., loc„ 

loc - loc., loc~ 

loc , loc« + loc 

loc., loc 9 - loc 

loc, + loc , loc - loc . 
1 2 3 4 

loc, * loc , loc_ % loc . 
12 3 4 

The resultant dump suppresses identical lines and an * is 
inserted next to the line number following the identical 
line encountered. An EBCDIC translation is included to 
the right of the dump. 

LINE FEED The line feed (or carriage return) character 

may be used in conjunction with loc and locj, I0C2 com- 
mands to dump the contents of the next location. 



IOC = value This command places the specified value into 

the specified location (loc) of the running monitor. (The 
display mode must be on.) The format of the command is 

loc = value 

where 

loc is the specified location. 

value is the specified value. 



MAP COMMANDS 

These commands turn the map mode on and off. They work 
only with interactive commands and apply only to a partic- 
ular user. The two map commands are 

MAP 

UNMAP 



MAP The MAP command loads the map of the specified 

user if his JIT is in core. The format of the command is 

MA[P], id 

where id is the user identification assigned by the system. 
Dump output following a MAP command is assumed to be 
virtual addressed. 



t This command may be used in conjunction with the 

loc and loci, I0C2 commands to dump the last location. 
The format of the command is 



UNMAP The UNMAP command turns the mapping mode 

of operation off. The format of the command is 

UN[MAP] 

Dump output following an UNMAP command is assumed to 
be physical addressed. 



* This command may be used in conjunction with the 

loc and loc], I0C2 commands to dump the location whose 
address is contained in the location specified by loc. The 
format of the command is 



SEARCH COMMANDS 

Commands in this group allow core to be searched. The 
commands are 



MONITOR The MONITOR command turns the monitor 

display mode on and off (as does any explicit command). 
When the display mode is on, the current monitor is dis- 
played. When the display mode is off, the dump is dis- 
played. The format of the command is 

MO[NITOR] [Dl[SPLAY]] 

where DISPLAY turns the monitor display mode on. Omis- 
sion of DISPLAY turns the monitor display mode off. 



COMPARE 

SMASK 

SEARCH 



COMPARE The COMPARE command compares dump lo- 

cations between loc] and loc2 with the running monitor, 
and outputs locations with nonequal contents. The format 
of the command is 



CO[M PARE], loc ^002 
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SMASK The SMASK command sets the mask to the 

specified value. The format of the command is 

SM[ASK], value 

where value is a hexadecimal mask. 



PRINT The PRINT command closes the output symbiont 

file to allow output to the line printer without requiring a 
return to TEL. The format of the command is 

PR[INT] 



SEARCH The SEARCH command searches for and outputs 
all words between locations loc] and I0C2 that contain the 
specified value under the mask. The format of the com- 
mand is 



SE[ARCH], value, loc., loc,, 



/her 



is a hexadecimal value. 



value 

loci is the beginning location and may be a hexa- 

decimal number or an expression indicating a sum 
or difference of two hexadecimal numbers. 

loco is the ending location and may be a hexadec- 

imal number or an expression indicating a sum or 
difference of two hexadecimal numbers. 



OUTPUT COMMANDS 

Commands in this group direct or format the output of 
ANLZ. Four output commands are provided: 

ROWS 
LP 
UC 
PRINT 

ROWS The ROWS command establishes the width of dump 

output. The format of the command is 

ROWS value 

where value is a number between 1 and 12. ROWS 1 would 
cause all hexadecimal dumps to be one word wide; ROWS 8 
would cause the dumps to be eight words wide. (Platen 
width may need to be extended at ROWS = 8. ) 

LP The LP command directs output from ANLZ to the 
line printer. The format of the command is 

LP [rows] 

where rows indicates the dump width in number of words. 

UC The UC command directs output from ANLZ to the 

on-line terminal. The format of the command is 

UC [rows] 

where rows indicates the dump width in number of words. 



DEBUG COMMANDS 

Commands in this group permit the use of Delta to facilitate 
monitor debugging. The three debug commands are 

BF 

DELTA 

NODELTA 



BF The BF command specifies the name of the boot file 
that represents the monitor being examined by ANLZ. 
This enables the debugger Delta to read in the required 
symbol tables. If the BF command is not specified, the file 
M:MON in :SYS is the boot file that is assumed by default. 

The form of the command is 

BF fid 

where fid is the file identification and is in the form 



name 



E 



[. [account] . password] I 
account J 



DELTA The Delta command associates the debugger 
Delta with ANLZ and gives control to Delta. If the 
BF command has been issued, the Delta command ;S loads 
the global symbol table of the monitor root from the spe- 
cified boot file. The Delta command name ;S loads the 
local symbol table of the module named. If the BF com- 
mand was not executed, the file M:MON in :SYS is used 
to obtain the monitor symbol tables and the Delta com- 
mands apply to the running monitor being examined, not 
to the monitor in the boot file. The Delta command ;G 
is used to exit from Delta and to return control to ANLZ. 

The form of the DELTA command is 
DE[LTA] 



NODELTA The NODELTA command disassociates the 

debugger Delta from ANLZ. The form of the command is 



NO[DELTA] 
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MISCELLANEOUS COMMANDS 



SPY COMMAND 



SYMBOLS This command creates an alphanumerically 

sorted monitor map by reading, sorting, and formatting the 
monitor's REF/DEF stack in the file MONSTK. :SYS. 

The form of the command is 

SY[MBOLS] [fid] 

where fid is used to select symbols from a file and has the 
format 

[T. account"). password 
.account J 

MONSTK. :SYS is the default. 



IS This command reads the sorted symbol table that was 

saved the last time ANLZ ran as a ghost job. The command 
produces no output. When the IS command is used, the 
SYMBOLS command is unnecessary. The format of the IS 
command is: 



IS 



SYMBOL/ The symbol/ command displays the contents of 
a monitor location. The format of the command is 

symbol/ 

where symbol specifies the name of a location in the 
monitor. 

Note: The symbol table must have been retrieved by use 
of the SYMBOLS or IS command prior to use of this 
command. 



DUMP This command causes a specified range of ad- 

dresses to be dumped. The command's format is 

DUMP loc.Joc. 

Dump output following a MAP command is assumed to be 
virtual addressed; after an UNMAP command, physical 
addressed. 

CLOSE This command causes the input dump file to be 

closed. The format is 

CL[OSE] 

A user should close a file prior to entering the monitor dis- 
play mode. 



HELP This command lists all ANLZ commands and op- 

tions, and gives a brief description of the purpose of each. 
The form of the HELP command is 

HE[LP] 



SPY SPY provides a mechanism for obtaining information 

about users currently in the system. If the ANLZ user has 
the proper privilege (i.e., CO or above), SPY will read the 
selected set of user JITs from the swap device and output 
them on the LO device (i.e., on the LP or UC). If the 
ANLZ user does not have sufficient privilege to allow direct 
I/O, SPY will try to obtain the selected user JITs from in 
core. However, it is unlikely that SPY will be able to 
capture the JITs of more than a few users at best. 

The format of the command is 

SPY [option] 

If no option is specified, all user JITs will be read. The 
options are: 

SWAP reads all user's JITs on the swap device. 

L, *\J. . . reads the JITs of the specified users. 

SWAP ^[, *]. . . reads the JITs of the specified users 

from the swap device. 

SNAP #[, #]. . . SNAPs the selected JITs. 

In general, users are specified by their user numbers. How- 
ever, batch IDs can also be used. 

The SNAP option causes the JIT to be output in the usual 
SNAP format. All other SPY output has the column headings 
listed in Table 11. 

Table 11. SPY Output 



Column 


Description 


USER 


B - batch job. 




O - on-line user. 




G - ghost job. 




* - JIT read from swapper. 


ACCOUNT 


The user's account number. 


NAME 


The user's log-on name. 


PRV 


The user's privilege level. 


PRI 


The user's current priority. 


PRB 


The user's base execution priority. 


LN/ID 


The user's line number if on-line. The 




user's SYSID and partition number if 




batch. 


STATE 


The user's current state. 
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Table 11. SPY Output (cont. ) 



1 Column 


Description 


PSIZ 


The user's peak si^e in decimc number 
of pages. 


PCT 


The user's current page count in 
decimal. 


CCBUF 


The last control card read or the last 
on-line command that TEL read. 


CPU - SEC 

i 


The number (in decimal) of seconds the 
user has been in core. 


REM - SEC 


The number (in decimal) of seconds the 
user has left to run in core. (Valid for 
batch jobs only. ) 


CAL - CNT 


The number (in decimal) of CALs the 
user has issued. 


DISCAC 

i 

1 


The number (in decimal) of RAD and 
disk accesses the user has performed. 


TAPEAC 


The number (in decimal) of tape ac- 
cesses the user has caused. 


APS 


The number (in decimal) of I/O ac- 
cesses per CPU second for the user. 


CPS 


The number (in decimal) of CALs per 
CPU seconds for the user. 


PG - CNT 


The number (in decimal) of line printer 
pages that the user has printed. 



EXIT COMMAND 

END The END command causes an exit from ANLZ. 

The format of the command is 

en[d] 



OUTPUT 

The output produced by ANLZ consists of displays of for- 
matted monitor and user tables and the contents of registers 
existing at the time of the crash. The time and date infor- 
mation in the output page headings refer to the time at 
which the crash occurred. 

Some of the output tables are chain type displays. That is, 
they are formed by starting at the head of a chained list and 
outputting that list until the tail of the chain is reached. If 
the tail and the last page in the chain do not agree, the fol- 
lowing message is output: 



TAIL ERROR 



If the count differs from the number of pages in the chain, 
the following message is output: 



COUNT ERROR 



Table 12 lists all of the ANLZ displays in order of appear- 
ance in the ANLZ dump. The left-hand column specifies 
the heading that appears at the top of each display. The 
right-hand column describes the contents of the display. 



Table 12. Displays 



Heading 


Contents 


REGISTERS: 


The contents of the registers at the time the dump was taken. 


TRAPS/INTERRUPTS: 


The output for trap and interrupt locations. The trap and interrupt locations 
are those used by the associated XPSD instructions and are listed in 
Table 13. 


PAGE IN WHICH TRAP OCCURRED: 


The core page in which the trap occurred, if a trap was the cause of the 
recovery. 


USER TABLES: 


The user tables. This display includes the tables associated with each 
user that has a page chain. The meaning and source of items in this dis- 
play are defined in Table 14. 


ADDITIONAL USER TABLES: 


The remainder of the User Tables display above. The meaning and source 
of items in this display are defined in Table 15. 
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Table 12. Displays (cont. ) 



Heading 


Contents 


USER STATE CHAINS: 


The user state chains which indicate the state of each user in the system. 


RESOURCE WAIT QUEUES: 


The queues of users waiting for resources. The queues are listed and de- 
fined in Table 16. 


SWAP TABLES: The swap (-ables. The meaning of each location in the table is defined 

in To hie 17. 


PARTITION TABLES: 


The partition tables. Table 18 defines the headings in this display. 


PROCESSOR TABLES: 


The processor tables. Table 19 defines the headings in the display. 


MONITOR (FREE) PAGE CHAIN: 


The monitor free page chain. The swapper page chain is formatted in the 
same manner as this display. Usually there is no page chain data 
output. 


USER PAGE CHAINS: 


The usei page chain display. This display indicates which pages and how 
many pages were being used by the various users resident in core. 


PROCESSOR PAGE CHAINS: 


The processor page chain display. This display indicates which pages and 
how many pages were being used by the various processors resident in core. 


READ AHEAD TABLES: 


The read-ahead tables. 


REAL TIME PAGES: 


The real-time page chain. 


XDELTA/HANDLER PAGE CHAINS: 


XDELTA's page chain. 


PHYSICAL MEMORY ALLOCATION: 


The actual physical memory allocation on a page-by-page basis. This 
display is a composite picture of the monitor free page chain, user page 
chain, and processor page chain displays, plus the resident monitor and 
its JIT, plus any unallocated pages. 


ALLYCAT TABLES: 


The ALLYCAT buffer adjustment tables. The headings used in this dis- 
play are defined in Table 20. 


UNALLOCATED PAGES: 


The contents of any unallocated pages. 


I/O CHANNEL DEVICE STATES: 


The I/O channel and device states. The display is separated into tables 
pertaining to each logical channel. For each channel, ANLZ prints the 
channel information table (CIT), the device control tables (OCT) for de- 
vices on the channel, and the user I/O request queues on those devices. 
Table 21 defines the headings used in the display. 


FREE QUEUE ENTRIES: 


The free queues entries which are used to contain user I/O requests for 
I/O devices defined in the I/O Channel Device States display above. 


CHANNEL INFORMATION TABLE: 


The channel information tables (CIT). 


DEVICE CONTROL TABLES: 


The device control tables (DCT). Table 22 defines the meaning of the 
headings used in this display. 
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Table 12. Displays (cont.) 



Heading 


Contents 


IOQ TABLES: 


The IOQ tables. Table 23 defines the meaning for the headings used in 
the IOQ tables display. 


COC TABLES: 


The COC tables. This display includes the line table values for those 
lines having an associated user (determined by a non-zero value in 
LB:UN). Table 24 defines the headings used in the COC tables display. 


RESOURCE ALLOCATION TABLES: 


The resource allocation tables. 


AVR TABLES: 


The AVR tables. Table 25 defines the headings used in the AVR tables 
display. 


IN CORE ERROR LOG DATA: 


The contents of the incore error log buffers. 


OUTPUT SYMBIONT TABLES: 


The output symbiont tables. The headings used in this display are 
defined in Table 26. 


*** ASSIGNED CPOOLS: 
*** AND THEIR SPOOLS: 


The contents of the assigned CPOOLs and corresponding SPOOLs. 


MONITOR JIT: 


The monitor JIT contents and the monitor TSTACK contents. TSTACK 
headings are defined in Table 27. 


CURRENT USER: 


The current user's JIT. 


CONTENTS OF TSTACK: 


The current user's TSTACK. TSTACK headings are defined in 
Table 27. 


ADDITIONAL JIT FOR USER* nn: 


The current user's AJIT (additional JIT). 


CONTEXT AREA FOR USER* nn: 


The current user's context area. 


*** PHYSICAL PAGE* nn: 


The current user's physical pages. 


MONITOR ROOT: 


The monitor root. 


RBBAT RECOVERY FILE: 


The RBBAT recovery file, which includes ghost communication buffers, the 
RBBAT environment, the RBBAT static data, and the RBBAT dynamic data. 
(Usually there is no dynamic data output. ) 


USER IDENTIFICATION: 


The user identification. This display is a composite of all JITs in the 
MONDMPfile. 


PATCH FILE: 


The patch file built by GHOST1 at system boot time. 


INSWAP USER: 


The current inswap and outswap users' core (if any). This figure has the 
same format as the Incore Users display. 


INCORE USERS: 


The current incore users' core. 


CONTROL SECTION MAP: 


A map of the monitor modules' start addresses. 


SYMBOL MAP: 


The symbol map. 


TABLE OF CONTENTS: 


The Table of Contents for the ANLZ dump. 
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Table 13. Trap and Interrupt Locations for XPSD 
Instructions 



Table 14. User Table Headings 



Location 




Name of 


of XPSD 


Meaning 


Handler 


X'40' 


Nona II owed operation trap 


NOPPSD 


X'41' 


Unimplemented instruction 
trap 


UN IMP 


X'42' 


Stack overflow trap 


STKOVF 


X'43' 


Fixed-point arithmetic 
overflow 


FIXOV 


X'44' 


Floating-point fault 


FLTFLT 


X'45' 


Decimal arithmetic fault 


DECFLT 


X'46' 


Watchdog timer runout 


CSE$ERR 


X'47 1 


Multiprocessing usage 


IPT47 


X'48' 


CAL1 instruction 


CAL1PSD 


X'49' 


CAL2 instruction 


CAL2PSD 


X'4A' 


CAL3 instruction 


CAL3PSD 


X'4B' 


CAL4 instruction 


CAL4PSD 


X'4C 


Hardware error trap 


CSE$ERR 


X'4D' 


Instruction exception trap 


CSE$ERR 


X'4E' 


XDELTA entry 


LEE20 


X'4F' 


JIT pointer 


- 


X'50' 


Power on 


PON PSD 


X'51' 


Power off 


POFPSD 


X'54' 


CLOCK3 counter 


- 


X'55' 


CLOCK4 counter 


- 


X'56' 


Parity error 


PERPSD 


X'58' 


Counter 1 zero 


CLK1PSD 


X'59' 


Counter 2 zero 


CLK2PSD 


X'5A' 


Counter 3 zero 


CLK3PSD 


X'5B' 


Counter 4 zero 


CLK4PSD 


X'5C 


Input/output interrupt 


IOPSD 


X'5D' 


Control panel 


OCPSD 


X'60' 


COC input interrupt 


COCIN1 


X'6T 


COC output interrupt 


COCOUT1 



Heading 


Source 


Meaning 


USER 


- 


Internal user number. 


ST 


UB:US 


User's state. 


BL 


UB:BL 


Link to previous user in 
same state. 


FL 


UB:FL 


Link to next user in same 
state. 


FLG 


UH:FLG 


User's flags. 


FLG2 


UH:FLG2 


Exit control bits, miscel- 
laneous control flags. 


JIT 


UBJIT 


Physical page address of 
user's JIT. 


SWPI 


UBrSWAPI 


Swap table index. 


HJIT 


UH:JIT 


Track/sector address on 
the swapping RAD of 
user's JIT. 


AJIT 


UH:AJIT 


Track/sector address 
of user's additional 
JIT. 


PCT 


UB.-PCT 


User's page count. 


ACP 


UB:ACP 


Number of associated 
command processor. 


APR 


UB:APR 


Number of associated 
processor's root. 


APO 


UB:APO 


Number of associated 
processor's overlay. 


ASP 


UB-ASP 


Number of associated 
special processor. 


DB 


UB:DB 


Number of associated 
debugger. 


OV 


UB:OV 


Number of associated 
overlay. 


MF 


UB:MF 


Number of l/O events 
outstanding. 
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Table 


15. Additional User Table Headings 


Heading 


Meaning 


USER 


User . ; ,ber. 


MISC 


Either time left for u>er to remain asleep 
or resource wait queue forward link. 


UH:DL 


DO-list address. 


CYL 


User's procedure cylinder number if disk 
pack swapper. 


PRI 


User's current priority. 


PR1B 


User's priority base value. 


f NECB 


Number of ECBs to be posted for this 
user. 


| UH.-NL 


Pointer to head of ECBs to be posted. 



Table 17. Swap Table Terms (cont.) 



Table 16. Resource Wait Queues 



! Name 


Description 


R:SYMF 


Users queued for symbiont file space. 


R:SYMD 


Users queued for symbiont disk granule. 


R:OCR 


Users queued for OPEN/CLOSE. 


R:DPA 


Users queued for swapper granule. 


R:QFAC 


Users queued for ALLOCAT. 


R:NQW 


Users queued for ENQ. 



Table 17. Swap Table Terms 



Location 


Meaning 


S:SIR 


Swap in requests posted. 


S:HIR 


High priority requests posted. 


S.-S1P 


Swap-in progress flag. 


# SWAP$DEV 


Interrupt bypass count. 


S:CUN 


Current user number. 


S:ISUN 


In-swap user number. 



Location 


Meaning 


S.-CUIS 


Count of users in system. 


S:IDLF 


Idle flag. 


SB:OSN 


Number of out-swap users. 


SB:OSUL 


Out-swap user list. 


S:BECL 


Beginning and end command list 




for each outswap user. 


SB:NP 


Number of in-swap processors. 


SB:PNL 


In-swap processor numbers. 


SB:FPN 


Number of freed processors. 


SB.-FPL 


List of freed processors. 


M:SWAPD 


Address of swap device. ! 


MB:SDI 


DCT index. 


MB:SFC 


Swap function code. 


MB:#RTRY 


Retry count. 


MrCLBGN 


Beginning of current command 




list. 


MHrCLEND 


End of current command list. 



Table 


18. Partition 


Tables Headings 


Heading 


Source 


Meaning 


# 


Calculated 


Index to partition tables. 


ACCOUNT 


PLDrACT 


Current running account. 


USR 


PLB:USR 


Number of users in 
partition. 


FLG 


PLH:FLG 


Partition control flags. 


QN 


PLH:QN 


Quantum time of 
partition. 


TOL 


PLH:TOL 


Total jobs run in this 
partition. 


CUR 


PLHrCUR 


Current Jobs selected in 
this partition. 


TL 


PLH:TL 


Lower time limit. 


TU 


PLH:TU 


Upper time limit 


SID 


PLH:SID 


System ID. 
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Table 19. Processor Table Headings 



111 

Heading 


Source 


Meaning 


p# 


- 


Processor index number. 


PrNAME 


PrNAME 


Processor name. 


HPP 


PB.-HPP 


Head of processor's physical page chain , 


TPP 


PBrTPP 


Tail of processor's physical page chain. 


PSZ 


PBrPSZ 


Processor's procedure size in pages. 


DSZ 


PB.-DSZ 


Processor's initial dafa size in pages. 


DCBSZ 


PBrDCBSZ 


Size in pages of DCB area. 


PDA 


PH:PDA 


Disk address of procedure. 


DDA 


PH:DDA 


Disk address of data and DCBs. 


UC 


PBrUC 


Use count on processor. 


LNK 


PB.-LNK 


First overlay number for this processor. 


PVA 


PB:PVA 


Virtual page address of the processor's procedure. 


HVA 


PB:HVA 


First page available to the processor. 


PC* 


PB:PC* 


Procedure cylinder number. 


DC* 


PB:DC # 


Data cylinder number. 


SA 


P:TCB 


Starting address and flags. 


TCB 


PrTCB 


TCB address. 



Table 20. ALLYCAT Headings 



Heading 


Meaning 


TOP 


Top index into buffer. 


BOTTOM 


Bottom index into buffer. 


WORDCNT 


Number of disk addresses in buffer. 


TEMPBOT 


Set if ALLYCAT changing buffer. 


BUFLAGS 


Bit = HGP empty, Bit 1 = buffer just filled, Bit 2 = buffer just emptied. 


ADJSTCNT 


Number of entries manipulated by ALLYCAT; may be either positive or negative. 


GRANULES AVAIL 


Total number of granules/cylinders remaining in system (in hexadecimal notation). 
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Table 21. I/O Table Headings 



Table 22. Device Control Table Headings (cont.) 



Heading 


Meaning 


CIT3-5 


Channel Information Tables 3-5 


DEVICE 


yyndd for this device 


ADDR 


Hardware address 


CX 


Channel index 


OIDTS 


From DCT3 - Set bits indicate: 




O output 




I input 




D down 




T timed out 




S SIO reject 


BPWXKCSB 


From DCT5 - Sets bits indicate: 




B Device busy 




P Clean-up pending 




W Wait until done 




X Data transfer 




K Wait for key-in 




C Control task 




S SIO while manual 




B BIN mode 


QX 


I/O queue index 


AIO 


Last AIO status 


TDV 


Last TDV status 



Table 22 


I. Device Control Table Headings 


Heading 


Meaning 


# 


DCT number. 


DEV 


Active I/O address. 


PRI 


Primary I/O address. 


ALT 


Alternate I/O address. 


CIT# 


Channel (CIT) index. 



Heading 


Meaning 


IOFLG 


I/O legality: 




1 1 = in and out 




10 = out only 




01 = in only 


DEV TYP 


Type mnemonic. 


DEV FLGS 


State of device. 


IOQ # 


IOQ index. 


CDW ADRS 


Command doubleword address (WA 




resolution). 


PRE HAND 


Handler preprocessor word address. 


POST HAND 


Handler postprocessor word address. 


ACT CNTR 


Device activity counter. 


IOINT 


Value to match against I/O 


DEADLINE 


clock. 


AIO INT STAT 


AIO status word. 


TDV STATUS 


TDV status doubleword. 


CHAN FLNK 


Link to next entry. 


PRE-EMPT 


Real-time pre-empt flag. 


IS 


7446 table. 


HAND CODES 


Handler function flags (first 8 bits 




contain retry function code; the 




second 8 bits contain the fol- 




low on code). 


TIME INCR 


Time-out increments. 


SIOCC 


SIO condition codes. 


TDVCC 


TDV condition codes. 


TIO STATUS 


TIO status. 


DISC FLAG 


Disk flag. 


HGP DISP 


Heading Granule Pool (HGP) 




displacement if disk. 


RMA FLGS 


Partitioning flags. 


SIO COUNTER 


Number of SIOs done to this 




device. 
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Table 23. IOQ Table Headings 



Table 23. IOQ Table Headings (cont.) 



Heading 


Meaning 


# 


IOQ table number. 


BAK 


Back link to next entry. 


FWD 


Forward link to next entry. 


DCT # 


DCT index. 


MNE 


TEXT name of device from SYSGEN. 


STAT 


Software status. 


FCN 


Original function code (IOQ4). 


CODS 


Current function code (IOQ5). 


DC BAD 


DCB word address (if any). 


BUF 


Buffer word address if bit and 1 reset; 
CDW word address if bit 1 set (swapper); 
CDW word address if bit set (other). 



Heading 


Meaning 


TIM 


Number of timeout increments. 


CDW 


Number of commands used if IOQ8 




bit or 1 set. 


NRA 


Original number of recovery tries. 


NRT 


Remaining number of recovery tries. 


RAD AD 


Disk address. 


EAADR 


End action word address. 


EA INFO 


One word to return to end action 




receiver. 


PRIO 


Priority of this event. 


USER 


User number of I/O requester. 



Table 24. COC Line Table Headings 



Heading 


Source 


Meaning 


LINE 


Calculated 


Line number. 


USER 


LB.-UN 


Associated internal user. 


TYPE 


COC TERM 


Terminal type. 


EOMTIME 


EOMTIME 


End of message time for a read. 


BUFCNT 


BUFCNT 


Number of buffers in use for line. 


CPOS 


CPOS 


Current carriage position. 


RSZ 


RSZ 


Record size requested by user while read is pending. 


MODE BYTES 


MODE-MODE4 


Terminal mode indicators. 


TL 


TL 


Pointer to tab buffer. 


II 


COCII 


Input insertion pointer for line. 


IR 


COCIR 


Input removal pointer for line. 


ARSZ 


ARSZ 


Accumulated record size while read is pending. 


CPI 


CPI 


Initial carriage position for a read. 


OI 


COCOI 


Output insertion pointer for line. 


OR 


COC OR 


Output removal pointer for line. 


OC 


COCOC 


Count of characters pending output. 
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Table 


25. AVR Table Headings 


Heading 


Meaning 


SER# 


Serial number of tape or pack. 


PUB 


Set if public. 


POS 


Set if positioned. 


AVR 


Set if AVRed. 


SCR 


Set if scratch tape. 


HLD 


Set if held. 


PTL 


Set if positioned to label. 


UPL 


Set if user positioned label. 


OPN 


Set if open. 


NOU 


Number of users. 


TPOS 


Tape mark count. 


USER 


User number. 


SOLICIT 


Index to special AVR tables. 


INI 


Set if volume initialized. 


VER 


Set if volume verified. 


MTD 


Set if mounted. 


PRIM 


Set if primary volume of private 
set of volumes. 


HGPDISP 


Displacement from HGP. 



Table 26. Symbiont Table Headings 



Heading 


Meaning 


# 

SQUE 

SNDDX 

TYPE 


Index number of table. 

Symbiont queue chain. 

DCT index of symbiont device. 

TEXT name of symbiont device 
from SYSGEN. 



Table 26. 


Symbiont Table Headings (cont.) 


Heading 


Meaning 


SSTAT 


Symbiont Status: 




= input symbiont 




1 = output symbiont 


SSIG 


Symbiont signal character (e.g., 
L, Q, etc.). 


SRET 


Symbiont return when activated 
from chain. 


SCNTXT 


Context block doubleword address 
displacement. 


SYMX 


Symbiont index: 




1 = input 




2 = output 


TYP 


Device type. 


LNK 


Remote chain. 


FLAG 


Remote flags. 


SUSP 


Suspend bit for IRBT. 


QUE 


IOQ index for IRBT. 


SQHD 


Symbiont queue chain head. 


SQTL 


Symbiont queue chain tail. 



Table 27. TSTACK Headings 



Heading 


Meaning 


ADDRS 


Virtual address of displayed contents. 


STACK OFFSET 


Index into stack. 


CONTENTS 


Contents of stack. 


RELATIVE LOC 


Address that stack contents point to, 
in symbol plus displacement form. 
If the stack cell contains a relative 
location, the instruction at that lo- 
cation will be displayed if it is an 
address modifying instruction (e.g., 
B, BAL, LPSD). 


INSTRUCTION 


Symbolic instruction at the address 
contained in the stack position. 
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ANLZ MESSAGES 



ANLZ COMMAND SUMMARY 



Table 28 contains the messages that are output by ANLZ. 
Most of these messages identify error conditions. Others 
merely supply information. 



Table 29 summarizes ANLZ commands. The left-hand 
column contains the command format, the right-hand column 
contains the command description. 



Table 28. ANLZ Messages 



Message 


. Description 


ANLZ HERE 


The ANLZ program has begun operation. 


ANLZ: ENTER COMMAND, N/L SAYS TO DO ALL 


This message issued to operator after GJOB ANLZ key-in. 
Operator may respond with one of the following: 

NO = just exit 

TA = read recovery-built tape 

HE = run interactively from console 

CP = read CP5DMP file 

0-7 = read indicated MON DM P file 

N/L = do default ghost run 


ANLZ GHOST FINISHED 


The ANLZ ghost has completed processing the core 
image file. 


ANLZ USING MONDMPn 


ANLZ has been commanded to read a MONDMP file. 
The value specified for n indicates the number of the 
MONDMP file. 


BAD COMMAND 


The command was unrecognizable. 


CANNOT OPEN FILE name 


The file specified by the INPUT command cannot be opened. 


CAN'T GET THE BUFFER 


The user was not allowed enough core in his account to 
read in the monitor symbol stack. 


COUNT ERROR 
TAIL ERROR 


The tail and last page in a chain do not agree. 


ENTER TAPE TYPE: 7T, 9T, BT, ETC. . . 


The user must supply the tape type if tape input is to be used. 


ERR/ABN CODE = xxxx**dcb 


An I/O error or abnormal condition occurred during an 
INPUT operation. 

xxxx is the error or abnormal code. 

deb is the address of the DCB associated with it. 


LOCI > LOC2 


The first location entered for a locj, I0C2 (or similar) com- 
mand was greater than the second location. 


xx PRIVILEGE LEVEL NOT HIGH ENOUGH 


The user privilege level was not high enough for the 
requested operation. 


SORRY, NO PAGE xx 


The page containing the location specified by the user 
was not found in the input file. 


THE LAST PHYSICAL PAGE IN THE FILE IS xx 


The size of the file read from tape by the INPUT com- 
mand is specified by the last physical page in the file. 
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Table 29. ANLZ Command Summary 



Command 


Description 


I 


Dumps the last location and is used in connection with loc 
and loc], loc2« 


* 


Dumps the indirect location and is used in conjunction with 
loc and loc j, loc2« 


ALE) 


Performs the functions of the INPUT, DISPLAY, and RUN 
commands and of ANLZ (except dumps) when initiated 
by the automatic recovery procedure. A numerically and 
alphanumerically sorted monitor map is output at the end of 
the ALL display. 


BF fid 


Specifies the name of the boot file that represents the monitor 
being examined by ANLZ. The file M:MON in :SYS is as- 
sumed by default. 


CL[OSE] 


Causes input dump file to be closed. 


CO[MPARE] # loc 1/ loc 2 


Compares the dump (locations loc] through I0C2) with the 
running monitor and outputs the locations with nonequal 
contents. 


DEJLTA] 

i 


Associates the debugger Delta with ANLZ. 


DI[SPLAY] option 


Outputs information existing at the time of the crash. The 
options are 

Aj[lTSj —JIT, AJIT, and context area of all incore users. 

AT[ABLES] -incore portion of ALLYCAT's tables. 

AV[R] -tape and disk tables. 

Cl[TS][, index] . . . —all or requested entries of Channel 
Information Tables. 

CO[C][, index]. . . —all or requested entries of COC tables. 

CU[N]— current user's JIT, AJIT, and context area. 

\ DC [T][, index], . .j— all or requested entries of Device 
1 Control Tables. 

EL[OGj —incore error log buffers. 

FQ-Free I/O Queue ing tables. 

IO[, chan] . . . —devices on requested I/O channels. 

IQ[, index]. . . —all or requested entries of I/O queue ing 
tables. 

JIT[, id][, loc 1 , loc2] —contents of the JIT for the user 

specified by id or for the monitor. 

MR[, loci, loc2]— monitor's root. 

Oj[lT]-all of the out of core JITs. 
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Table 29. ANLZ Command Summary (cont. ) 



Command 



Description 



Dl[SPLAY] option (cont.) 



OS — user outswap tables. 

PA[RTITIONS][, index]. . . -all or requested entries of 

partition tables. 

PF[lLE] —patch file that was created last. 

PM-page matrix identifying the owners of all pages. 
PN-processor inswap tables. 

PP, pageno[, loci, loc2] —contents of the indicated 
physical page. 

RA[T] —resource allocation tables. 

RE [GISTERS]— software check code, software check mess- 
age, and the first two register blocks. 

RBI!"] —remote batch tables. 

RC[Xt] —area of memory occupied by the recovery routines. 

RQ —resource subqueue lists. 

ST[ABLE] —output symbiont tables. 

SW[APPERj— contents of the swap/swap scheduling tables. 
SY[MBIONT]-RBBAT recovery file. 

TP —transaction processing tables. 

TRJAPS] —contents of trap and interrupt locations. 

TS[TACKj[, id] —temp stack of the user specified by id or 
of the monitor. 

USJERJL, idj . . . —user tables of the specified users. 

VP,pageno[, loci, loc2]— contents of the specified virtual 
page. 

WHY —software check code and software check message. 



DU[MP] loc 1 ,loc 2 



Dumps specified range of addresses. 



EN[D] 



Exits from ANLZ. 



he[lp] 



Lists all ANLZ commands. 



IN [PUT] option 



Directs ANLZ to input from a particular disk or tape file or 
to open a file. The options are 

LA[STJ — opens the last file formed by the recovery 
procedure . 
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Table 29. ANLZ Command Summary (cont.) 



Command 


Description 


IN [PUT] option (cont.) 


number —opens the numbered crash file formed by the 
recovery procedure. 




TA[PE] — reads a labeled tape created by the recovery 
procedure. 




CP[5DUMP] -opens the CP5DUMP file. 


IS 


Reads the sorted symbol table from a previous ANLZ run. 


Line Feed (or carriage return) 


Dumps the contents of the next location and is used in con- 
junction with loc and loci,loc2. 


loc 


Outputs the contents of the specified location. 


loc.., loc^ 


Outputs the contents of memory locations between loc. 
and loco. 


loc = value 


Places the value in the specified location of the running 




monitor. 


LP[rows] 


Directs the output of ANLZ to the line printer, where rows 
is dump width in hexadecimal words. Default is full line. 


AAA [P], id 


Loads the map of the specified user if his JIT is in core. 


mo[nitor] [di[splay]] 


Turns the monitor display mode on and off. 




MONITOR turns the display mode off. 




MONITOR DISPLAY turns the display mode on. 


no[delta] 


Disassociates the debugger Delta from ANLZ. 


pr[int] 


Closes the output symbiont file to allow output to the line 
printer without requiring a return to TEL. 


RO[WS], value 


Establishes width of dump output in number of words, where 
value may be 1 through 12. 


RU[N] option 


Outputs various linked lists of the monitor by running through 
the list and displaying each entry. The options are 




MO[NITOR] ,{ ] -monitor pages. S # the default, 
*- P9 J indicates all. A specific page 
may be requested. 




PROCESSOR] [,£ a J 


— processor pages. S, the de- 
fault, indicates all. A par- 




ticular processor may be 
specified. 




RT — real-time page chains. 




ST[ATE] , I A\ — state queues. A particular queue 

L -J number may be specified, or S, the 
default, indicates all. 
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Table 29. ANLZ Command Summary (conr.) 



Command 


Description 


RU[N] option (cont.) 


US[ER] , j . ,| — user pages for a particular user (id), or 
•- J for all users (S). S is the default. 

XD[ELTA] - XDELTA's page chains. 


SE[ARCH], value,loc ,/loc. 


Searches for and outputs all words between loc, and loc« that 
contain the value under the mask. 


SM[ASK], value 


Sets the mask to the specified value. 


symbol/ 


Displays the contents of the monitor location specified by 
symbol. 


SY[MBOLS][fid] 


Creates a numerically sorted monitor map, using the fid spec- 
ified or MONSTK. :SYS. 


UC[rows] 


Directs the output of ANLZ to the on-line terminal, where 
rows is dump width in hexadecimal words. Default is full line. 


UN [MAP] 


Turns off the mapping mode of operation. 
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5. ERROR MESSAGE FILE 



INTRODUCTION 

The error messages for the CP-V monitor and several CP-V 
processors are contained in an error message file, called 
ERRMSG. This file is initially created either through 
punched card or on-line terminal input and is maintained 
through use of the Edit processor. This chapter describes 
the structure of the ERRMSG file and the techniques 
required to create and modify the file. 

Codes for detected error conditions are recorded in the job 
information table (JIT). The error code is placed in J.-ABC 
(high-order byte) and the subcode is placed in ERO (right- 
justified). When CCI (batch jobs) or TEL (on-line jobs) is 
entered, a message is printed to correspond to the code and 
subcode. This message is obtained from the error message 
file (ERRMSG) via a keyed read using a key constructed 
from the group code, error code, and subcode. If either 
the file or the record corresponding to the code is missing, 
the error code itself will be printed. Otherwise, the mes- 
sage and the error code will be printed. 



FORMAT OF ERROR MESSAGE FILE 

Each record in the error message file contains the EBCDIC 
text of one error message. The key of each record is one 
word long and has the form 



03 



GC 



EC 



SC 



i 2 3 I 4 5 6 7 1 8 9 10 111 12 13 14 15116 17 18 19l 20 21 22 23(24 25 26 27 1 28 29 30 31 

The first byte always contains 03, which is the count of 
bytes in the key. The second byte is the group code, the 
third is the error code, and the fourth is the error subcode. 

Group codes presently assigned are 






Monitor 


5 


CCI 


1 


PCL 


6 


DRSP 


2 


Loader 


7 


Batch 


3 


TEL 


8 


Analyze 


4 


Runner 







Messages in the file with group codes other than zero are 
not handled by the monitor itself. Error codes currently 
assigned within the monitor group are 

— 7F I/O error and abnormal codes 

80 - 9F COBOL error codes 

A0 - BF Other Monitor codes 

CO - FF Unused 



The meaning of the assigned codes are defined in CP-V/TS 
Reference Manual, 90 09 07, CP-V/BP Reference Manual, 
90 17 64, and in the ANS COBOL/LN Reference Manual, 
90 15 00. 



CREATING ERROR MESSAGE FILE 

The ERRMSG file is initially entered into the system either 
througha card reader or an on-line terminal at the central site . 
The procedures for each type of input are described below. 



Warning: If an installation modifies the text of TEL error 
messages, it should be noted that TEL stores dy- 
namic information in the error message buffer and 
some of the text may be clobbered. 



CARD READER INPUT 

Card input of the error message file is handled by the Error 
Message File Writer (ERRMWR). This program reads cards, 
interprets the first six columns as a hexadecimal number, 
converts this number into a three-byte key, and writes the 
card image exclusive of trailing blanks as a keyed record 
in the ERRMSG file in the account under which ERRMWR is 
executed. This account should be :SYS for the system error 
message file. 

The card format is 

/n 2 3 45678 9 10 11 12 13 14 15 16 17 18 192021 22 



Hex. code 



GC 



EC 



SC 



Text of Message 



Example: 

Assume that the message ILLEGAL OPCODE is to be placed 
in the error message file for the monitor error code AE. The 
group code and subcode in this case are both zero. Thus, 
the card for this message would be punched as follows: 

1 23 456 78 9 10 11 12 13 14 15 16 17 18 19 20 



Hex. code 



00 



AE 00 



Text of Message 



ILLEGAL OPCODE 



Keys generated by the ERRMWR program have the form 



03 



1 2 3 14 5 6 7 



GC 
(col. 1-2) 



itf? 



9 10 111 12 13 14 15 



EC 

(col. 3-4) 



16 17 18 19120 21 22 23 



SC 

(col. 5-6) 



24 25 26 27(28 29 30 31 
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During conversion of the key, leading blanks are treated as 
zeros. Non hexadecimal letters result in output of a warn- 
ing message and cause the card to be ignored. The card 
image is scanned from right to left to determine the rightmost 
nonblank character, and the count of characters is adjusted 
so that trailing blanks are not written. A new line character 
X' 15' is appended to the message. 



The message may be continued in column 1 of the follow- 
ing card by appending a continuation character (;) at the 
end of the message in the first card. Only two cards per 
message are allowed. 



A card containing an asterisk in column 1 is a control card 
and is used to set the format of the record written in the 
file. If column 2 of the control card contains a 0, the 
message key is appended to the front of the message text 
and is included in the record. If column 2 of the control 
card contains a 1, the key is not included in the record 
text (this is the default condition). Control cards can be 
placed anywhere within the data deck except between 
continuation cards. 



TERMINAL INPUT 

Creating or modifying the error message file can be ac- 
complished from the terminal by using Edit or ERRMWR. 

Example 1 : Using Edit 

JBUILD MSG0 

1 . 000 O0ABO0 THAT'S NO DEBUGGER.'® 
2. 000 00 ABO 1 THAT'S NO OP CODE © 
3.000 © 

JSET M:EI DC/MS G© 

JERRMWR © 

Example 2: Using ERRMWR 

JSET M:EI UC © 

_[ERRMWR © 

>00AC01 DON'T ISSUE CAL3 OR CAL4© 

>© 
! 
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6. SYSTEM ERROR LOG FILE 



INTRODUCTION 

All hardware malfunctions and some software problems 
occurring during system operation, whether recovered or 
not, are recorded in a special disk storage file. This file 
is periodically copied into a standard file (ERRFILE) by a 
ghost program (ERRrFIL) which is initiated automatically 
for that purpose. 

ERRFILE may be listed and summarized by the Error Log 
Listing processor that is described in this chapter. ERRFILE 
is also available for on-line preventive maintenance of 
the system and for diagnosis and prediction of hardware 
malfunctions. 



ERR.FIL PROGRAM 

ERRrFIL copies the special file created by ERRLOG onto a 
normal keyed file (ERRFILE) in the rSYS account that is more 
readily available to diagnostic programs. 

ERRrFIL is a ghost job that is awakened by ERRLOG when- 
ever five errors have been recorded. ERRrFIL may also be 
awakened by a program with diagnostic privilege by using 
the initiate job CAL(CAL1,6 FPT)or by an operator key-in 
of GJOB ERRrFIL. 



ERROR LOG LISTING PROCESSOR 

The Error Log Listing processor (ELLA) provides an efficient 
tool for listing and sorting the error log file, ERRFILE, which 
is automatically generated and updated by the CP-V system. 
(ERRFILE is described in Appendix E. ) ELLA output furnishes 
a meaningful and comprehensive diagnostic evaluation of 
the system and its peripherals, aiding in the early detection 
of product failures and thus increasing the reliability, main- 
tainability, and availability of the system. 

The set of ELLA commands allows the user to first specify 
the kinds of errors in which he is interested, and then re- 
quest a listing of those kinds. Four types of listings are 
availabler 

• A chronological listing of error log entries. 

• A sorted listing of error log entries. 

• A summary of error log entries by category. 

• A summary of error log entries in graphic form. 



STARTING EXECUTION 

ELLA may be run as an on-line, batch, or ghost job. Normal 
operating procedures are observed in each of these modes. 
Batch and on-line operations are illustrated in Examples 1 
and 2. These first two examples are intended only for ELLA 
users who are not familiar with CP-V. 

The use of ELLA is restricted to authorized system users whose 
accounts have a diagnostic privilege level (AO or higher). 
If the user has insufficient privilege, ELLA will abort with 
the message 



INSUFFICIENT PRIVILEGE LEVEL ABORT 



Note.- Initiating ELLA as a ghost job enables the operator 
to issue ELLA commands from the operator's console. 
However, judgement should be exercised when ini- 
tiating ELLA in this fashion since ELLA commands 
will be intermixed with normal operator console 
material. 

INPUT/OUTPUT ASSIGNMENTS 

ELLA input and output is divided into three separate 
functions r 

• Error log input. 

• User command input. 

• Listing output. 

Error log input is always taken from the system error log file, 
ERRFILE. Without user intervention, the remaining two 
functions assume default assignments depending on the mode 
in which ELLA is run. The default assignments are listed in 
Tables 30, 31, and 32. (They are based upon the assumption 
that the Sland LO operational labels weregiven the standard 
assignments during SYSGEN. ) The assignment of the output 
listing function may be altered by the user during ELLA ex- 
ecution through use of the ELLA SET command. The tables 
specify the ELLA SET command formats that are required to 
make the reassignments. The SET command is described in 
detail below. 

SET The SET command reassigns the listing and message 

output device assignment during execution of ELLA. (It 
changes the device assignment in the MrLO DCB. ) The for- 
mat of the command is 



SET 



.""•{SI 



where 



Towards the end of this chapter, there is a section which 
contains a set of predefined tasks that should be useful to 
the person who needs periodic error log reports but has no 
need for a more precise understanding of the ELLA processor's 
command structure. (See "Predefined Tasks".) 



LP specifies line printer. 

KP specifies operator's console for the ghost and 
batch modes and on-line terminal for the on-line 
mode. 



System Error Log File 65 



Example 1. Batch Operation of ELLA 




For batch operation of ELLA, control commands and ELLA commands are punched on cards and the cards are submitted 
to the site operator. 

In this example, the account number (FEOPER) and account name (SITE 102) were chosen because they had been re- 
served for diagnostic activity at that particular site. In order to run ELLA in the batch mode, the account was 
authorized a privilege level of A0. (The privilege level is not specified on the JOB card because it is automatically 
associated with the account.) The execution priority E was specified to given the fob a high execution priority. (The 
privilege level determines the types of things that a jab is allowed to do; the execution priority is a determining fac- 
tor in how quickly a job will be selected for execution. ) 



Example 2. On-Line Operation of ELLA 



XEROX CP-V AT YOUR SERVICE 

ON AT 13:48 JUL 08, '74 

LOGON PLEASE: FEOPER, SITE102 ,RSD © 

JELLA® 

13:49 JUL 08, '74 

ELLA 7080D6-AOO 



*END© 
XPRINT © 

JOFF© 

In this example, the user logged onto the system after receiving the CP-V salutation and log-on request. The account 
number and name used are the same as in the previous example. (The account was authorized for both batch and on- 
line operations. ) The account has a password associated with it which is to be used for security reasons during on-line 
operation; i.e., if the password is kept confidential, it prevents unauthorized on-line use of this special diagnostic 
account. The password is entered following the name and account. Here, the password RSD was entered. 
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After the log-on, CP-V prompted for input with an exclamation point. The user entered 

ELLA® 

to request the Error Log Listing program and ELLA respondedwith its salutation and prompted for input with an asterisk. 
The user then entered ELLA commands, finishing with the END command which returned control to the system. The 
system then prompted with an exclamation point. (Actually, control was returned to a system command processor 
called TEL which is described in detail in the CP-V/TS Reference Manual, 90 09 07.) 

ELLA can output its listing on the user's terminal or on the line printer. If printer output is selected, the system holds 
the output on a disk file until either the PRINT or OFF command is entered. In the example, the user executed the 
PRINT command which caused the system to produce the printer output. The user then proceeded to perform other 
tasks, eventually ending the on-line session with the OFF command which logged the user off the system. 



INPUT/OUTPUT CHARACTERISTICS 

Whenever ELLA listing output is assigned to the line printer, 
the output contains two additional types of information: 
user commands received and diagnostic messages. ELLA 
user commands are listed on the printer to present a com- 
plete record of the user listing session. They are preceded 



by one asterisk. Diagnostic messages (due to abnormal con- 
ditions or operational errors) are preceded by two asterisks. 

Whenever the command input function is assigned to the 
operator's console (ghost initiation of ELLA) or the user's 
terminal (on-line initiation), diagnostic messages are 
printed on that input device (preceded by two asterisks) as 
well as on the line printer. 



Table 30. ELLA On-Line I/O Functions 



Function 


Associated 
DCB 


Default 
Assignment 


Possible 
Assignments 


ELLA SET 

Reassignment 

Command 


Comments 


Source 
error log 


M:BI 


ERRFILE 


ERRFILE 


(none) 


Data base from which ELLA reads source, records 
for printing. 


Command 
input 


M:SI 


User's 
terminal 


User's 
terminal 


(none) 


Device from which ELLA reads commands (and 
to which it prints diagnostic messages). 


List 
output 


M:LO 


User's 
terminal 


User's 
terminal 


SET, LIST, KP 


Device to which ELLA lists error log data. 


Line 
printer 


SET, LIST, LP 


Device to which ELLA lists error log data, com- 
mands received, and diagnostic messages. 



Table 31. ELLA Batch I/O Functions 



Function 


| Associated 
DCB 


Default 
Assignment 


Possible 
Assignments 


ELLA SET 

Reassignment 

Command 


Comments 


Source 
error log 


M:BI 


ERRFILE 


ERRFILE 


(none) 


Data base from which ELLA reads source records 
for printing. 


Command 
input 


M:SI 


Card 
reader 


Card 
reader 


(none) 


Device from which ELLA reads commands. 


List 
output 


M:LO 


Line 
printer 


Line 
printer 


SET, LIST, LP 


Device to which ELLA lists error log data, com- 
mands received, and diagnostic messages. 


Operator 's 
console 


SET, LIST, KP 


Device to which ELLA lists error log data and 
diagnostic messages. (Using the operator's con- 
sole for lengthy output is not recommended. ) 
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Table 32. ELLA Ghost I/O Functions 



Function 


Associated 
DCB 


Default 
Assignment 


Possible 
Assignments 


ELLA SET 

Reassignment 

Commands 


Comments 


Source 
error log 


M:BI 


ERRFILE 


ERRFILE 


(none) 


Data base from which ELLA reads source records 
for printing. 


Command 
input 


M:SI 


Operator's 
console 


Operator's 
console 


(none) 


Device from which ELLA reads commands (and 
to which it prints diagnostic messages. ) 


List 
output 


M:LO 


Line 
printer 


Line 
printer 


SET, LIST, LP 


Device to which ELLA lists error log data, com- 
mands received, and diagnostic messages. 


Operator's 
console 


SET, LIST, KP 


Device to which ELLA lists error log data and 
diagnostic messages. (Using the operator's con- 
sole for lengthy output is not recommended.) 



INTERRUPTING ELLA EXECUTION 

On-line ELLA execution may be interrupted at any time by 
use of the BREAK key on the user's terminal. This causes 
ELLA to terminate its current activity and to prompt for a 
new command. 

When ELLA is initiated as a ghost Job or a batch |ob, ex- 
ecution may be interrupted through use of the operator INT 
key-in. The effect upon a ghost job is similar to that of the 
BREAK function on-line. The effect upon a batch job is to 
cause the next command to be read from the card reader. 



SLIS produces a sorted listing of qualified error log 

entries. 

SUM produces a categorized summary of qualified 
error log entries. 

DISP produces a summary of qualified error log en- 
tries in graphic form. 

END terminates ELLA. 



ELLA COMMANDS 

ELLA accepts three types of commands: boundary commands, 
task commands, and the device assignment command (SET, 
described previously). Boundary commands establish or 
change the limits that are to be applied to all subsequent 
task commands; i.e., boundary commands allow the user to 
specify the types of errors in which he is interested. Task 
commands initiate the execution of a particular type of list- 
ing. The device assignment command is used to change the 
listing and message output device during execution of ELLA. 



Note that error log entries are displayed only if they qualify. 
To qualify for inclusion in a display, an error log entry 
must pass aM boundary tests in force at the time the display 
is generated. If no boundary commands have been entered, 
all error log entries qualify. Those error log entries which 
fail to pass one or more of the boundary tests are ignored. 
(Boundary commands are described following the task 
commands. ) 



CLIS The CLIS command requests a chronological list- 

ing of the error entries in the order in which they appear in 
the error file. 



TASK COMMANDS 

Task commands are used to request the ELLA displays and to 
terminate ELLA. ELLA task commands are: 

CLIS produces a chronological listing of qualified 

error log entries. 



The format of the CLIS command is 



C[LIS] 



An example of a CLIS listing is given in Example 3. Table 33 
lists the error log entry headings printed by ELLA and notes 
the manner in which all values are printed. 



68 Error Log Listing Processor 



Example 3. Use of the CLIS Command 



In this example, the user chose to initiate ELLA on-line. The user did not desire a lengthy listing at his terminal. 
Therefore he reassigned the listing function to the line printer using the SET command. 

_!ELLA© 
*SET,LIST,LP® 
*CLIS © 
*END® 
JMPRINT© 

After the CLIS command was issued, ELLA produced the chronological listing and then prompted for another command. 
The user desired no further listings, so he terminated ELLA with the END command. He then issued the system PRINT 
command which caused the listing to be output to the printer. The output that was sent to the line printer is shown 
below: 



♦CLIS 



CHRONOLOGICAL LISTING 



FROM 00/00/00 00:00:00:000 
TO 12/31/99 23:59:59:999 



*** SYSTEM IDENTIFICATION *** 

CORE 
TIME (K) SITE I.D. SYSTEM 

11:36:00:000 00128 PRT101 CP-V COO 



-OPTIONS TIME 

CPU SYMB RT RB ONLN TP MP RES 

S67 Y Y Y Y Y Y 02 



*** CONFIGURATION *** 







I/O 


ADRS 


DCT 


TIME 


MDL 


PRIM 


ALTN 


INDEX 


11 :36:00:000 


7012 


0001 


0001 


01 




7140 


0003 


0003 


02 




7160 


0004 


0004 


03 




7445 


0002 


0002 


04 




7212 


01F0 


01F0 


05 


11 :36:00:000 


7322 


0080 


0080 


06 




7322 


0081 


0081 


07 




7271 


00E0 


00E0 


08 




7271 


00E1 


00E1 


09 




7271 


00E2 


00E2 


0A 


11 :36:00:000 


7271 


00E3 


00E3 


0B 




7611 


0010 


0010 


OC 



*** TIME STAMP *** DATE=07/10/74 TIME=1 2:00 :00 :004 



*** SIO FAILURE *** 







I/O 


SIO- 


TDV- 


SUBC 


TDV CUR 


REM 




TIME 


MDL 


ADRS 


STAT CC 


STAT CC 


STAT 


COMM DA 


BYTES 


MFI 


12:36:30:782 


7323 


0083 


2000 6 


1000 6 


00 


0011B7 


0001 


00 


12:37:29:518 


7323 


0083 


2000 6 


1000 6 


00 


0011B7 


0001 


00 


12:40:10:398 


7323 


0083 


2000 6 


1000 6 


00 


0011B7 


0001 


00 
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*** TIME STAMP *** 
*** TIME STAMP *** 



DATE=0 7/1 0/74 TIME=1 3:00 :00 :005 
DATE=0 7/1 0/74 TIME=1 4 :00 :00 :00 3 



***SYMBIONT INCONSISTENCY*** 

DCT REL. SYMB. 
TIME INDEX SECT. DCT 

14:03:13:648 09 0110 02 



*** TIME STAMP *** 
*** TIME STAMP *** 



DATE=07/10/74 TIME=15:00:00:004 
DATE--0 7/1 0/74 TIME=1 6 : 00 :00 :006 



Nofe that the CLIS command is listed in the line printer listing and that the existing time boundaries are printed after 
the title. If other boundaries were in force, they too would have appeared. Certain values, such as core size and 
recover/ count, are printed in decimal for convenience. Other fields, such as the OPTIONS field, contain flags. 
The true condition is represented by the letter Y, the false condition by the letter N. In this example, the system 
has symbiont capability but does not have remote processing and real-time facilities. 



Table 33. Error Log Entry Headings 



Heading 


Description 


ACCOUNT 
eeeeeeee 


The account (eeeeeeee) in which the faulty file resides. 


---AIO- 
STAT CC 

XXXX X 


A hexadecimal number (xxxx) representing the AIO device and 
operational status bytes (STAT) and a hexadecimal value (x) 
representing the condition code (CC) returned as the result of the 
AIO instruction. 


CL 

XX 


A hexadecimal value (xx) representing the cluster portion of the 
unit address. 


CONTRLR 
f 


A flag (f) indicating whether or not the controller is partitioned in 
addition to the device. Y means the controller is partitioned; N 
means it is not partitioned. 


CORE 

(K) 

dddd 


Core size in decimal thousands (dddd). 


COUNT 
dddd 


The number of entries (in decimal) that duplicate the previous entry. 


CPU 
ddd 


CPU type (ddd). 


CPU 
ADRS 

XXXX 


CPU hardware address. 


CUR COMM DW-- 

1 2 

XXXXXXXX XXXXXXXX 


Two hexadecimal numbers (xxxxxxxx) representing the command 
doubleword currently being processed for a device. 


DATE 
mm/dd/yy 


The month (mm), day (dd), and year (yy) that the error log entry 
occurred. 


DCT 
INDEX 

XX 


A hexadecimal value (xx) indicating the order in which the device is 
configured into the system at SYSGEN. The index value for the first 
device is 1. 
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Table 33. Error Log Entry Headings (cont. ) 



Heading 


Description 


ENTRIES 

LOST 

dddd 


A decimal value (dddd) representing the number of error log records 
lost when logging became temporarily impossible for any reason. 


ENTRY 
COUNT 
dddd 


A decimal value (dddd) representing the number of entries in the 
enqueue table belonging to the specified user at the time the error 
log entry was made. 


ERROR 

CODE 

xxxx 


A hexadecimal value (xxxx) giving the error type code for the failure. 
See Appendix B, "Monitor Error Messages" in the CP-V/BP Reference 
Manual, 90 17 64, for error code definitions. 


ERRLOG- — 
CALL ADRS 
xxxxxxxx 


A hexadecimal value (xxxxxxxx) representing the caller's address to 
which the error logging routine will return when logging is completed. 
This is used in isolating software faults. 


FILE NAME 


The name of the file in which a fault has been detected. 


---HIO- 
STAT CC 
xxxx X 


A hexadecimal value (xxxx) representing the status (STAT) and a 
hexadecimal value (x) representing the condition codes (CC) re- 
turned in response to an HIO instruction. 


- -INDEX- - 
BAD ENTRY 

XXXXXXXX 


The hexadecimal offset (xxxxxxxx) into a 64-word block in ERRFILE 
that locates the first word of the incorrect entry. 


I/O 

ADRS 

xxxx 


A hexadecimal value (xxxx) representing the physical I/O address. 


I/O 
COUNT 
dddddddddd 


A decimal value (dddddddddd) representing the number of SIO 
instructions executed for a device. This value is reset at system boot 
time and is not reset at recovery (i.e., it is reset for system start-up 
types 1, 2, and 3; see START TYPE in this table). 


I/O ADRS 
PRIM ALTN 
xxxx xxxx 


A hexadecimal value (xxxx) representing the primary I/O address 
(PRIM) by which a device can be referenced, and another hexa- 
decimal value (xxxx) representing the alternate address (ALTN) for 
dual access devices. 


--I/0-- 
STAT CC 

XXXX X 


A hexadecimal value (xxxx) representing the status (STAT) and a 
hexadecimal value (x) representing the condition codes (CC) re- 
turned in response to an I/O instruction. 


LOCATIONS 

xxxxxxxx 

xxxxxxxx 


One to fourteen hexadecimal values indicating the addresses of the 
first fourteen (or less) memory locations exhibiting parity errors. 


--MEMORY STATUS -- 

1 2 
xxxxxxxx xxxxxxxx 


Two hexadecimal values (xxxxxxxx) representing the status returned 
in response to an LMS instruction. 


---MEMORY STATUS WORDS 

12 3 
xxxxxxxx xxxxxxxx xxxxxxxx 


Three hexadecimal values (xxxxxxxx) representing status returned in 
response to an LMS instruction. 


MDL 
dddd 


A decimal number (dddd) that uniquely identifies peripheral devices 
by the Xerox model number (defined at SYSGEN). 
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Table 33. Error Log Entry Headings (cont. ) 



Heading 


Description 


MFI 

XX 


A hexadecimal value (xx) representing the current state of the 
memory fault indicators returned by the hardware in response to an 
RD instruction. All memory fault indicators will be reset. (Sigma 6 
and 7 only. ) 


MODE 
d 


A decimal value (d) encoding the mode in which the file was opened 
where: 1 - IN; 2 - OUT; 4 - IN OUT; 8 - OUTIN. 


- -OPTIONS -- 

SYMB RT RB ONLN TP MP 
f f f f f f 


Indicates whether or not the following facilities are available in the 
system; symbiont routines (SYMB), real-time processing (RT), remote 
processing (RB), on-line facilities (ONLN), multiprocessing facilities 
(MP), and transaction processing functions (TP). The flag (f) is equal to 
Y (present) or N (absent). 


ORG 

d 


A single decimal digit that indicates the file organization where: 
1 - consecutive; 2 - keyed; 3 - random. 


PAR 
ERRS 

XXXX 


A hexadecimal value (xxxx) representing the number of memory 
locations exhibiting parity errors after a memory scan. 


--POLL- 
STAT CC 

XXXX X 


A hexadecimal value (xxxx) representing the processor fault status 
(STAT) and a hexadecimal value (x) representing the condition 
codes (CC) returned by the hardware in response to a POLP or 
POLR instruction. 


POLR 
RESULTS 
xxxx 


A hexadecimal value (xxxx) representing the processor fault status 
as returned by the hardware in response to a POLR instruction.' 


PSDW 

1 2 
xxxxxxxx xxxxxxxx 


Two hexadecimal numbers (xxxxxxxx) representing the contents of 
the program status doubleword. 


j RB: FLAGS 
xxxxxxxx 


A word containing bits which define the current state of processing for 
the failing remote station. The meanings of the bits are defined in 
Table 32-1 


REAL 
ADRS 
xxxxxxxx 


A hexadecimal value (xxxxxxxx) representing the actual memory 
address. In an unmapped system, this is the same as the IA field 
of the PSD. 


RECOV 
COUNT 
dd 


A decimal value (dd) which is set to zero at system initialization and 
incremented by one for every system recovery. 


REL. 

SECT. 

xxxx 


A hexadecimal value (xxxx) representing the relative sector at which 
the inconsistency was detected 


RELATIVE - 
SECT.ADRS 
xxxx 


A hexadecimal value (xxxx) representing the relative sector number 
at which the inconsistency was detected. A relative sector is 256 
words long with each sector on a given device being numbered from 
zero through device end. CP-V maintains file pointers by relative 
sector number to expedite addressing different devices. 
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Table 33. Error Log Entry Headings (cont. ) 



Heading 



Description 



REM 

BYTES 

xxxx 



A hexadecimal value (xxxx) representing the remaining byte count 
as returned in response to a TDV instruction. 



-RE TRY - 

REQ REM 

dd dd 



A two digit decimal number (dd) representing the maximum number of 
retries (REQ) after which a device error is returned to requester (value 
obtained from requester's DCB), and another two-digit value (dd) 
representing retry request minus the number of entries attempted (REM). 
The range is between retry request and 0. A value indicates the 
operation was terminated due to retry count rundown. 



RP1 
xx 



RP2 
xx 



RP3 
xx 



RP4 

XX 



RP1 through RP4 have unique meanings for each type of remote 
terminal. See Tables E2 through E7 of Appendix E. 



SCREECH 
CODE 
xx 



The hexadecimal code (xx) used by CP-V to identify the system 
failure that has occurred. See Appendix C. 



SEEK ADRS 
xxxxxxxx 



A hexadecimal value (xxxxxxxx) representing the physical disk 
address last used to access this device. 



SENSE INFORMATION -- 

xxxxxxxx xxxxxxxx xxxxxxxx xxxxxxxx 



A hexadecimal value (xxxxxxxx) representing the diagnostic infor- 
mation returned from the device as a result of sending a "sense" order 
to the device. The value has a 4-word maximum, depending on the 
device. 



---SIO- 
STAT CC 

XXXX X 



A hexadecimal value (xxxx) representing the status (STAT) returned 
in response to an SIO instruction, and another hexadecimal value 
(x) representing the condition codes (CC) returned. 



SITE I.D. 
eeeeeeee 



An EBCDIC value (eeeeeeee) identifying the site (specified at 
SYS GEN). 



START 

TYPE 

xx 



A hexadecimal value (xx) indicating the degree of initialization: 

1 - POboot (initial) 

2 - PO boot under the files 

3 - System device boot (no recovery) 

4 - System recovery 

5 - Operator recovery 



SUB 

CODE 

xx 



A hexadecimal code (xx) that differentiates several similar CP-V 
software check codes. See Appendix C. 



SUBC 

STAT 

xx 



A hexadecimal value (xx) representing the status (STAT) of the I/O 
subchannel received as a result of a TDV instruction. The first byte 
of the second word of the status received from the device is: 






where bit 1 indicates bus check fault if set to one. 

bit 2 indicates control check fault if set to one. 
bit 3 indicates memory interface error if set to one. 
(Xerox 560 only). 
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Table 33. Error Log Entry Headings (cont. ) 



Heading 


Description 


SUBTYPE 

XX 


A hexadecimal value (xx) indicating the type of copy error that 
occurred. Type 01 indicates read error; i.e., the ghost ERRrFIL re- 
ceived an error indication when reading the original error file. 
Type 02 indicates read error end, meaning that subsequent error log 
entries were correctly read from the original error file. Type 03 indi- 
cates a length error; i.e., the original error file record length was 
incorrect. Type 05 indicates incorrect time; i.e., the time of the 
following entry is either out of range or goes backward. Type 06 
indicates illegal entry type; i.e., the type code of the following 
entry was found to be illegal by the ghost ERRrFIL. 


SYMB. 
DCT 

XX 


A hexadecimal value (xx) representing the order in which the sym- 
biont device is configured into the system; i.e., the DCT index of 
the symbiont device. 


SYSTEM 
CP-V eee 


Displays the operating system name (CP-V) and three EBCDIC char- 
acters (eee) representing the system version specified at SYS GEN. 


TDV CUR 
COMM DA 

XXXXXX 

1 


A hexadecimal value (xxxxxx) representing the current command 
doubleword address returned in response to a TDV instruction. The 
address is in doubleword form. Therefore it should be multiplied by 
two to obtain the absolute word location. 


---TDV- 
STAT CC 

XXXX XX 


A hexadecimal value (xxxx) representing the status (STAT), and a 
hexadecimal value (x) representing the condition codes (CC) returned 
in response to a TDV instruction. 


TIME 

hh :mm:ss :nnn 


The time the error occurred, in hours (hh), minutes (mm), seconds (ss), 
and milliseconds (nnn). 


TIME LAST 
DUPLICATE 
hh :mm:ss :nnn 


The time in hours, minutes, seconds, and milliseconds at which the 
last duplicate of the preceding entry occurred. 


TIME LAST 
LOST ENTRY 
hh:nrai:ss :nnn 


The time of occurrance when the last entry was lost in hours, min- 
utes, seconds and milliseconds. 


TIME 

RES 

dd 


A decimal value (dd) in milliseconds representing the resolution of 
the time field of all error log entries; e.g., if the time resolution is 
2, then the time value for all error log entries is accurate to two 
milliseconds. 


— -TIO- 
STAT CC 

XXXX X 


A hexadecimal value (xxxx) representing the status (STAT) and a 
hexadecimal value (x) representing the condition codes (CC) returned 
in response to a TIO instruction. 


- -TRAPPED -- 
INSTRUCT CC 

XXXXXXXX X 


A hexadecimal value (xxxxxxxx) representing the contents of the 
location pointed to by the trapped instruction's address (INSTRUCT) 
in the PSD, and another hexadecimal value (x) representing the trap 
condition codes (CC). 


TRAPPED 

INSTRUCT CC EFF.ADRS 

XXXXXXXX X XXXXXXXX 


A hexadecimal value (xxxxxxxx) representing the contents of the 
location pointed to by the trapped instruction's address (INSTRUCT) 
in the PSD; a hexadecimal value (x) representing the trap condition 
codes (CC); and another hexadecimal value (xxxxxxxx) representing 
the final address (EFF.ADRS) computed for the trapped instruction. 
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Table 33. Error Log Entry Headings (cont. ) 



Heading 


Description 


UN 

XX 


A hexadecimal value (xx) representing the unit portion of the Xerox 
560 unit address. 


UNIT 
NAME 
eeee 


A two-to-four EBCDIC character mnemonic name identifying one of 
the following: CPU; MI (Memory Interface); PI (Processor Interface); 
MI OP (Multiplexed Input Output Processor); RMP (Rotating Memory 
Processor); CT (Communication Terminator); SU (System Unit). 


USER 
I.D. 
xxxx 


A hexadecimal value (xxxx) which is a unique number assigned by 
the system to the particular job or session. 


USER 
NO. 

XX 


A hexadecimal value (xx) representing the index into internal system 
tables used to access user-specific information. 


VOLUME 
SERIAL 
eeeeee 


Four to six EBCDIC characters (eeeeee) that a user has supplied to 
identify a tape or private disk pack. 


WORKSTATION 

NAME 

eeeeeeee 


A one to eight EBCDIC character name which defines the identity 
and characteristics of a remote station to the system. A workstation 
name is not necessarily associated with one fixed physical terminal. 
The workstation name is specified when the remote terminal logs on. 


message 


An operator message of up to 72 alphabetical characters. 









Table 34. 


RBrFLAGS Structure 


Bit 


Name 


7670 


2780 


IRBT 


Meaning 





BPBIT 


X 


X 




Block protect toggle (ACKO/ACKI). 


1 


IGBIT 


X 


X 


X 


Cards after IFIN were ignored. 


2 


M ORBIT 


X 






Waiting for next portion of deck. 


3 


HUBIT 


X 


X 


X 


Line hung up. 


4 


PUN BIT 


X 






Punching is allowed. 


5 


DCBIT 


X 


X 


X 


WSN specified at SYSGEN. 


6 


HASPBIT 


X 


X 


X 


IRBT line. 


7 


SLVBIT 






X 


This system is slave. 


8 


ALBIT 


X 


X 


X 


RBLOG key-in done. 
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Table 34. RB:FLAGS Structure (cont. ) 



Bit 


Name 


7670 


2780 


IRBT 


Meaning 


9 


XP1BIT 






X 


XI specified in Super. 


10 


2780BIT 


X 


X 


X 


2780 line (may be changed to IRBT at logon). 


11 


IBMBIT 






X 


N3 specified in Super. 


12 


DIALBIT 


X 


X 


X 


DIAL specified at SYSGEN. 


13 


EDISBIT 


X 


X 


X 


ERROR MAX on line. 


14 


OFFBIT 


X 


X 


X 


Do not connect line (RBX) - Set except at logon 
for IRBT. 


15 


RBXBIT 


X 


X 


X 


Disconnect line now. 


16 


DUPBIT 


X 


X 


X 


1 - full-duplex; — half-duplex. 


17 


DISC BIT 


X 


X 


X 


Disconnect when output done. 


18 


LOFBIT 


X 


X 


X 


RBDISC sent (temporary setting). 


19 


SYS BIT 


X 


X 


X 


:SYS jobs legal. 


20 


HALBIT 


X 


X 


X 


HOLD all flag set. 


21 


CLKBIT 






X 


Wait before ACKO-idle. 


22 


ACTBIT 


X 


X 


X 


Line logged on. 


23 


CRTBIT 


X 






RBBAT disables RBSSS. 


24 


XP2BIT 






X 


X2 specified in Super. 


25 


OADBIT 


X 


X 


X 


Set OFFBIT after disconnect. 


26 


FIABIT 


X 


X 


X 


RBCC altered the stream status. 


27 


SSSBIT 


X 






Inputting with output suspended. 


28 


LIPBIT 


X 


X 


X 


Logging on. 


29 


FINBIT 


X 






FIN has been read. 


30 


EMBIT 


X 


X 




1 — NOEM specified; — EM specified. 


31 


OB BIT 






X 


Old BCB was read. 


31 


FRBIT 


X 






Initial read of file. 
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SLIS A sorted listing is requested with the SLIS 

command. The command has the form 

SL[IS] 

As in the chronological listing, the sorted listing includes 
all qualified error log entries. In this listing, however, 
entries are ordered by their type, and if they are peripheral 
class errors, by their model number and I/O address also. 

Error records are first categorized by ELLA as system, pe- 
ripheral or secondary records, (see Table 35). System records 
and their associated secondaries are listed first. Except for 
the system ID record and configuration record (which are 
printed in front of all other records), system records are 
listed in ascending type code order as given in Table 35. 
Secondary records are printed following their associated 
primary records. 

Peripheral class records are sorted in three phases. They are 
first separated by model number and printed in ascending 
model number order. All peripheral records with the same 
model number are then separated and listed in ascending 



device address order. Finally, all the records containing 
both the same device address and the same model number are 
printed in ascending type code order. Any secondary rec- 
ords associated with peripheral class entries are printed 
following the associated peripheral records. 

Any secondary record that appears in the error file that can- 
not be linked with a primary record through the above rules 
of association will be printed after all peripheral records 
and their associated secondaries under the heading 

>»UN ASSOCIATED SECOND ARIES<« 

Each time a record is listed that has a different device 
address than that of the preceding record listed, a Model 
Number/Address heading is produced under the heading 

>»MODEL NO. :xxxx I/O ADDRESS; xxxx 

where MODEL NO. is the 4— digit Xerox model number 
designation of the device and I/O ADDRESS is the 4— digit 
(hexadecimal) I/O address of the device. 

An example of a sorted listing is given in Example 4. 



Table 35. Error Log Entry Types 



Name 


Type 
Code 


Description 


System Class 


COPY ERROR 


10 


Recorded as a result of error conditions in the error logging 
mechanism. The particular malfunction is identified in the 
subtype field (see SUBTYPE in Table 32). If the record sub- 
type is 03, 05, or 06, the record is followed by the 64-word 
buffer in which the error occurred. 


PARITY ERROR 


17 


Recorded when program execution is interrupted to loca- 
tion X'56' (MFI) on Sigma 6 or 7 or is trapped to location 
X'4C (parity trap) on Sigma 9 or Xerox 560. 


SYSTEM STARTUP 


18 


Recorded when the system is booted and at each recovery. 


WATCHDOG TIMER 


19 


Recorded when program execution traps to location X'46' 
due to a watchdog timer run-out condition. 


FILE INCONSISTENCY 


1A 


Recorded when the operating system cannot access a file in 
the file management system. The code displayed is described 
in Appendix Bof the CP-V/BP Reference Manual, 90 17 64. 


SYMBIONT INCONSISTENCY 


IB 


Recorded when the operating system cannot access a 
symbiont file in the symbiont file management system. 


INSTRUCTION EXCEPTION 


ID 


Recorded when program execution traps to location X , 4D I 
on Sigma 9 or Xerox 560 due to an instruction exception 
condition. 


LOST ENTRY 


IE 


Recorded when error log buffering constraints, timing 
considerations, and error detection rates force error log- 
ging to be temporarily suspended or otherwise impossible. 
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Table 35. Error Log Entry Types (conr. ) 



Name 


Type 
Code 


Description 


System Class (cont.) 


POWER ON 


20 


Recorded when the hardware power monitor forces 
program execution to trap to location X'51' as a result 
of detecting a restoration of power condition. This 
normally occurs as a result of a power outage of 500 
milliseconds or more in duration. 


CONFIGURATION 


21 


Peripheral device configuration data recorded when 
ERRFILE is entered. 


SYSTEM IDENTIFICATION 


22 


System information recorded when ERRFILE is entered. 


TIME STAMP 


23 


The date and time which is recorded when ERRFILE is 
entered in the system and every hour on the hour. 


BAD GRANULE RELEASE 


24 


Recorded when either a bad disk address has been de- 
tected or when the granule to be released is already free 
(dual allocation). 


REMOTE PROCESSING 
ERROR 


26 


Recorded when an error is detected in the transmission of 
data to or from a remote processing workstation. 


OPERATOR MESSAGE 


27 


A message entered by the operator through use of the 
ERSEND key-in. 


PROCESSOR FAULT INTERRUPT 


30 


Recorded when there is a processor fault interrupt (loca- 
tion X'56') on the Xerox 560. 


MEMORY FAULT INTERRUPT 


31 


Recorded when there is a memory fault interrupt (loca- 
tion X^? 1 ) on Sigma 9 or Xerox 560. 


PROCESSOR CONFIGURATION 


41 


Processor configuration from Configuration Control Panel 
(Xerox 560 only) recorded when the system is booted. 


ENQUEUE TABLE OVERFLOW 


50 


Recorded to log specific information after the operating 
system has detected an enqueue table overflow condition. 


UNKNOWN TYPE = xx 


XX 


An unknown type code xx has been encountered by ELLA 
in an error log entry. 


Peripheral Class 


SIO FAILURE 


11 


Recorded when the condition codes returned by the SIO 
instruction are such that either CClor CC2are true. Con- 
ditions that indicate IOP busy, or lack of operator action 
such as "device manual" may not be considered an error 
condition (and in such case will not be recorded). 


DEVICE TIMEOUT 


12 


Recorded when the time-out value specified by DCT11 
has been exceeded. 
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Table 35. Error Log Entry Types (cont. ) 


Name 


Type 
Code 


Description 


Peripheral Class (conr. ) 


UNEXP. INTERRUPT 


13 


Recorded when no match can be found between the I/O 
address returned in the status register by the AIO instruc- 
tion and any DCT1 I/O address of a device known to be 
busy. AIO CC - llxx will not be logged. 


j DEVICE ERROR 

i 


15 


Recorded when an I/O request is not successful upon one 
of the specified number of retries. (It may or may not 
have eventually been successful. ) 


PARTITIONED RESOURCE 


51 


Recorded when a resource has been partitioned from the 
system. 


RETURNED RESOURCE 


52 


Recorded when a previously partitioned resource has been 
returned to the system. 




Secondary 


Data Class 


DEVICE ERROR 
SECONDARY 


16 


Recorded when nonzero sense data is available following 
a device error. 


1 DUPLICATE ENTRIES 

i 

1 
1 


IF 


Recorded when the error logging mechanism detects 
identical consecutive errors. This prevents the error log 
from becoming saturated with redundant information. 


SECONDARY POLL 
RECORD 


32 


Recorded for each nonzero poll status received by the 
processor polling routines. 


MEMORY PARITY 
SECONDARY 


42 


Recorded for each memory unit that has recorded an error 
as determined by the memory polling routines (i. e., bits 22- 
31 of status word zero are nonzero) for Xerox 560. 


MEMORY PARITY 
j SECONDARY 


43 


Recorded for each memory unit that has recorded an error as 
determined by the memory polling routines (i.e., bits 22- 
31 of status word zero are nonzero) for Sigma 9. 


MEMORY PARITY 
SECONDARY 


44 


Recorded to log specific information obtained by scan- 
ning memory to attempt to isolate locations which cannot 
sustain correct parity. 



Example 4. Use of the SLIS Command 



For this example, the following batch job deck was submitted. 
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In the resultant sorted listing below, all related entries are grouped together. This facilitates the scanning of the 
error log that is necessary in order to determine the common characteristics of related failures that have occurred 
over a period of time. 

Note the OPERATOR MESSAGE entry in the listing. Such messages can be entered into the error log at the 
operator's console by means of the ERSEND ke/-in. (See the CP-V/OPS Reference Manual, 90 16 75. ) 



SORTED LISTING 



FROM 7/10/74 
Tn U/31,'99 



12:00:00.000 
23:59:59:999 



♦♦♦ FILE INCONSISTENCY ♦*• 

DCT 
TIME ACCOUNT INDEX 

16:03:13:648 771731 09 

16:42:32:197 771731 09 



RELATIVE 






ERROR 


SECT ADRS 


MODE 


ORG 


CODE 


0110 


01 


02 


757P 


0110 


01 


02 


757F 



RTRTEXT:V1 I 3 
RTRTEXT:V113 



-FILE NAME- 



♦*♦ TIME STAMP *** 

♦»* TIME STAMP ♦*♦ 

♦♦* TIME STAMP ♦♦♦ 

♦♦♦ TIME STAMP ♦*♦ 

♦♦♦ TIME STAMP ♦♦♦ 



DATE=07/10/74 
DATE=07/10/74 
DATE=07/10/74 
DATE-0 7/1 0/74 
DATE=0 7/1 0/74 



TIME=12:00:00:004 
TIME=13:00:00:004 
TIME=14:00:00:004 
TIME=1 5:00:00:004 
TIME=16:00:00:006 



♦♦•OPERATOR MESSAGE^* TIME = 14:22:03:782 
9TA81 CAPSTAN DRIVE NOISY (JDR) 



>>> MODEL NO:7160 I/O ADDRESS:0004 «< 



♦♦* SIO FAILURE ♦♦• 

SIO- 

TIME STAT CC 

07:02:28:922 2A42 6 
15:05:21:166 2A42 6 



TDV- 


SUBC 


TDV CUR 


REM 




STAT CC 


STAT 


COMM DA 


BYTES 


MFI 


2042 6 


00 


001179 


004C 


00 


2042 6 


00 


001179 


004C 


00 



♦♦♦ DEVICE ERROR ♦*♦ 

AIO- 

TIME STAT CC 

15:09:20:862 0048 6 



TIO- 


TDV- 


TDV CUR 


REM 


I/O 


CUR COMM DW — 


STAT CC 


STAT CC 


COMM DA 


BYTES 


MFI COUNT 


1 2 


1842 


2042 2 


00118B 


0000 


00 00000009B4 


09008C70 2E000078 



-RETRY- VOLUME SUBC 
REQ REM SERIAL STAT SEEK ADRS 
03 03 00 O000O0OB 



MODEL NO:7271 I/O ADDRESS :00E0 <<< 



♦♦♦ DEVICE ERROR •*♦ 











AIO- TIO- TDV- 


TDV CUR 


REM 




I/O 


TIME 






STAT 


CC STAT 


CC STAT CC 


COMM DA 


BYTES 


MFI COUNT 


12 


|56 


21 


278 


0458 


6 1842 


0442 2 


001 1C7 


0000 


00 


0000089148 


15 


42 


55 


694 


0458 


6 1842 


0442 2 


000A7E 


0000 


00 


0000138032 


15 


42 


55 


•906 


0458 


6 1842 


0442 2 


000A7E 


0000 


00 


0000138036 




DEVICE ERROR SECONDARY 




















I/O 

ADRS 

00E0 














12:56 


:21 


•284 


00F90A02 


0305F500 00CA0000 00000000 






15 


42 


:55 


:700 


O0E0 


00E70500 


0119FA02 80CA0000 00000000 






15 


4 2 


:55 


910 


00E0 


00E7O500 


0119FA0E 03E20000 00000000 







—CUR COMM DW — 

1 2 

02031800 1E000800 
02075800 1E000570 
02075800 1E000570 



-RETRY- VOLUME SUBC 

REQ REM SERIAL STAT SEEK ADRS 
03 03 00 O0F90A00 
08 08 00 00E70404 

08 07 00 00E70U04 
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SUM The SUM command requests a summary of the 

contents of the error file which lists the total number (in 
decimal) of qualified error log entries for each error type. 
The command has the form 

SU[M] 

In addition to error totals, the summary contains an I/O 
activity count for each device that has enors recorded. IO 



ACTIVITY is the count of all SlOs issued to a given device 
for the time period covered by the summary. 

Unlike other listings produced by ELLA, logical device 
addresses are used in the summary rather than physical ad- 
dresses. For example, a device CRA03 would appear as 
A03 and a device DCBFO would appear as BFO. 

Example 5 provides an example of the SUM command. 



Example 5. Use of the SUM Command 








SELLA© 
*SUM© 














ERROR S U 


M M 


A 


R Y 








FROM 07/10/74 
TO 12/31/99 


00 
23 


:00 
:59 


:00: 
:59: 


000 
999 






SYSTEM ERRORS 














TYPE 

SYSTEM STARTUP 

CONFIGURATION 

SYSTEM I.D. 

TIME STAMP 

FILE INCONSISTENCY 




ERRORS 
1 
6 
1 
16 
2 






DEVICE ERRORS 














IO SIO 
MDL ADRS FAIL 
7140 A03 
7160 A04 

7322 A80 

7323 A83 3 
7323 A84 
7323 A85 
7271 AEO 
7232 BFO 


UNEXP 
INTRPT 










DEV 

ERROR 
13 
6 
78 
3 
4 
6 
3 
2 


DEV 
TIMEOUT 


















IO 

ACTIVITY 

0000014798 

0000004906 

0000227574 

0000018295 

0000021926 
********** 

0000161268 
0000248749 


TOTAL ERRORS: 


00144 











DISP The DISP command requests a graphical display 

of error log entries. The DISP command has the form 

DI[SP] [, interval] 

where interval specifies the time interval, in minutes, to be 
used for the graph. The interval specified may range from 1 
to 60. The default interval is ten minutes. 

The graph produced by the DISP command is a bar graph. 
Each line begins with the end time of the interval, followed 
by the 2— digit error type code of each error recorded during 



the interval. If the number of errors for a given interval 
exceeds 30, then only the first 30 error type codes are 
printed, and FF is printed at the end of the line. 

Only qualified error log entries are included. Time Stamp, 
Configuration, and ID entries are always excluded. 

The first and last lines in the graph are the first and last 
intervals within the TIME boundary that contains qualified 
error log entries. The actual time period scanned is printed 
at the beginning of the listing. 

An example of a graphic display is given in Example 6. 
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Example 6. Use of D ISP Command 



The user in Example 5 continues as follows: 

*DISP,45© 

GRAPHIC DISPLAY 



FROM 00/00/00 
TO 12/31/99 



TIME ERROR 



03:56 15 



00:00:00:000 
23:59:59:999 



•10- 



04:41 
05:26 
06:11 
06:56 
07:41 
08:26 
09:11 
09:56 
10:41 
11:26 
12:11 



1A1A 



15161515161615111516 
1B11 121515111515 
15 



2715 



END OF FILE 



•20- 



•30- 



The distribution of errors over the scanned time period is more readily apparent in this display than in the other, forms 
of error listings. This display is used to check for patterns and trends in error occurrences. The digits that form this 
bar graph are in pairs, (e.g., the line JBl 1121515111515 contains eight digit pairs). Each digit pair represents one 
error and the two digits are the type code of the error. 



END The END command terminates ELLA and exits to 

the monitor. The format of the command is 

E[ND] 



BOUNDARY COMMANDS 

The boundary commands are used to select specified portions 
of the error file for display. In order for an error record to 
be accepted for display, it must satisfy each boundary. 
There are four boundaries: 

• Time 

• Model number 

• Device address 

• Error type code 

An error log entry will be listed by a subsequent task com- 
mand if it was recorded within the time limits specified by 



the TIME command and if it has one of the error type codes 
specified by the TYPE command. If the entry is a peripheral 
class entry (see Table 33), it must also have a model number 
field and an address field which agrees with one of the model 
numbers and one of the device addresses specified by the 
MOD and DEV commands respectively. 

It is not necessary, however, to use any of the boundary 
commands. If a boundary command is not used or a boundary 
has been reset, all error log entries are considered to have 
met the conditions of display for that boundary. 

Boundary commands, if judiciously used, can be especially 
helpful in minimizing ELLA output when the output listing 
function has been assigned to a slow speed device such as an 
on-line terminal. 

RSET The RSET command resets all boundary parameters 

to their default values. (The default values are given in the 
subsequent boundary command descriptions. ) The RSET com- 
mand has the form 

R[SET] 
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TIME The TIME command sets both date and time 

boundaries. Error log entries are displayed only if they 
occurred between the begin date and time and the end date 
and time. The TIME command has the form 

Tl[ME][,begin][-end] 

where begin and end have the form 

[month/day/year] [, hourrminute] 
or 

[hour:minute][, month/day/year] 

where 

month = 1-12 

day = 1-31 

year = 01-99 

hour = 00-23 (24 hour clock) 

minute = 00-59 



If the TIME command is not used (or if time and date are 
reset by the RSET command) ELLA establishes the following 
beginning and ending times: 

begin = 00/00/00, 00:00 

end = 12/31/99, one millisecond before midnight. 
(The time is recorded internally in millisecond 
increments. ) 

If only one group (i.e., 'begin' or 'end') is entered under 
the TIME command, the current state of the other group re- 
mains in affect. 

It is not necessary for both fields within a group to be 
entered. If time is the only field entered in a group, then 
the date for that group is the current day by default. Time 
by default is a bit more complex. If the date field is the 
only field entered for 'begin', then 00:00 is the time by de- 
fault. If the date field is the only field entered for 'end' 
then 1 millisecond before midnight is the time by default. 

Examples of the TIME command are given in Example 7. 



Example 7. TIME Command Usage 



The following series demonstrates TIME command usage. Assume all of the TIME entries have been entered consecu- 
tively at the console. 

*TIME, 4/25/73-5/27/73 ® 

The time limits have been set by the entry above as follows: starting time is 00:00 on A/25/73, and ending time in 
one millisecond before midnight on 5/27/73. The only error log entries that will be displayed by subsequent task 
commands are those that lie between these two time points. 

*TIME, 2:00- 8:00 © 

The limits have now changed so that the starting time is 2:00 AM on the current day (i.e., the day on which the ELLA 
run is being made), and ending time is 6:00 PM on the current day. (When no date is entered, the current date is 
implied.) 

*TIME, 18:00-10:00© 

This entry is illegal and will produce a diagnostic message because the starting time is later than the ending time. 
The limits 2:00 and 18:00 from the previous entry are still in effect. 

*TIME 00:00 © 

Here the starting time has been changed to 00:00 on the current day. Since no ending time has been entered, the 
previous ending time of 18:00 remains in effect. 

*TIME, 1/1/74-1 2 K)0© 

This sets the starting limit to 00:00 on 1 January 1974, and the ending limit to noon on the current day. 

*TIME, -13:00© 



Error Log Listing Processor 83 



The 


previously entered starting limits (1/1/74) remain in effect because no starting parameter is 


entered here. 


The 


end' 


ng limit is changed to 13:00 for the current day. 
j^RSET© 










ELLA time default's are reestablished. The default is 


the entire time 


span of the error log. 








*HME, 12:00, 10/15/73-10/16/73, 12:00® 










Fina 


lly, the starting time is set to noon on 10/15/73 


and the ending 


limit to noon on 10/16/73. 


Note that the order 


of ti 


me and date entry is immaterial. 











TYPE The TYPE command allows the user to select 

error log entries for display by specifying an error record 
type code (see Table 33). The TYPE command has the form 



TY[PE],{° 



type 1 [ / ...type 5 ] 



type is a hexadecimal error type code. 

specifies that the default (all types) is to be 

reestablished. 

. If error log entry types have been specified via the TYPE 
command, error log entries are displayed only if they have 
a type code equal to one of the types specified. Up to five 
types may be specified for display at one time. 

If the TYPE command is not used, records of all types are 
displayed (including any records that may have illegal type 
codes). Displaying all types is the default condition. Hav- 
ing once used the TYPE command, the default condition 
may be reestablished by entering TYPE, or by using the 
RSET command. 

Each time the TYPE command is used, the previoualy spe- 
cified types are replaced with the newly entered types. 

DEV The DEV command selects error log entries for 

display by specifying up to five I/O addresses. The DEV 
command has the form 



DE 



®l 



address, [, . . .address,.] 



address is a 1 to 4— digit hexadecimal physical I/O 
address. (Leading zeros in the address need not be 
specified.) 

specifies that the default (all devices) is to be 
reestablished. 

Up to five physical I/O addresses may be specified. Each 
time the DEV command is used, the previously specified ad- 
dresses are replaced with the newly entered addresses. 

If this command is not used, records are displayed without 
regard to their associated device address. This is the default 



condition. Having once used the DEV command, the default 
condition may be reestablished by entering DEV, or by 
using the RSET command. 

When particular device addresses have been specified through 
use of the DEV command, error log entries classified as sys- 
tem records (see Table 33) are not displayed, and a peripheral 
class entry is displayed only if the device address field in 
that entry is equal to one of the addresses specified by the 
DEV command. 

MOD The MOD command selects error log entries for 

display by specifying up to five model numbers. When par- 
ticular model numbers have been specified through use of 
the MOD command, error log entries classified as system 
records (see Table 33) are not displayed, and a peripheral 
class entry is displayed only if the model number associated 
with that record is equal to one of the model numbers spe- 
cified by the MOD command. The MOD command has the 
form 



M 
where 



[OD],{ 







model, [, . . .modeL] 



model is a 4— digit model number (e.g., 7446, 7271). 

specifies that the default (all models) is to be 
reestablished. 

Each time the MOD command is used, the previously spe- 
cified model numbers are replaced with the newly entered 
model numbers. 

If this command is not used, records are displayed regardless 
of their associated model number. This is the default con- 
dition. Having once used the MOD command, the default 
condition may be reestablished by entering MOD, or by 
using the RSET command. 

Examples 8 through 12 demonstrate the use of the MOD, 
DEV, and TYPE commands for selecting specific portions of 
ERRFILE for display. The examples are consecutive portions 
of one continuous on-line session. In these examples, the 
user has chosen to display everything at the terminal. This 
means that the user will be able to see the output immedi- 
ately, but the user must make judicious use of this rather 
slow output device. 
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Example 8. Use of the MOD, DEV, and TYPE Commands 



Assume that the user had already requested and received a summary of the error file (which would be a logical first 
step). The user then proceeded to display the operator messages present in the error file. 

*TYPE,27© 
*CLIS© 



CHRONOLOGICAL LISTING 



TYPE =27 

FROM 00/00/00 

TO 12/31/99 



00:00:00;000 
23:59:59: ( -99 



*** OPERATOR MESSAGE *** 
9TA81 CAPTSTAN NOISY (JBR) 



TIME = 12:33:00:079 



Note that the TYPE parameter is listed at the beginning of the display because TYPE is no longer set to the default. 

Because only one type of error was requested, the terminal is a practical display device. If more than one type of 
error is requested, a slightly different procedure can be used as shown in the next example. 



Example 9. Use of the MOD, DEV, and TYPE Commands 



The user from the previous example next desired to examine some system failures. Note that the new TYPEs entered 
in this example replace the old TYPE entered in the previous example. 

When more than one type of error is requested, a sorted listing often reduces the time required for output. This, is due 
to the fact that ELLA only prints headings when a new type of entry is to be listed and SLIS groups all related entries 
together. 

*TYPE,18,1B© 
♦SLIS® 



SORTED LISTING 



TYPE =18 1B 
FROM 00/00/00 
TO 12/31/99 



00:00:00:000 
23:59:59:999 



*** SYSTEM STARTUP *** 







START 


RECOV 


SCREECH 


SUB- 


TIME 


DATE 


TYPE 


COUNT 


CODE 


CODE 


09:32:00:000 


07/10/74 


04 


01 


19 


00 


12:05:00:000 


07/10/74 


01 


01 


00 


00 


17:21:00:000 


07/10/74 


05 


02 


00 


00 



***SYMBIONT INCONSISTENCY*** 

DCT REL. SYMB. 
TIME INDEX SECT. DCT 

11:29:08:406 09 00A0 02 
16:03:13:648 09 0110 02 
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Example 10. Use of the MOD, DEV, and TYPE Commands 



The user proceeded as follows: 



*TYPE, 17© 
jpEV, 1F0® 
*CLIS© 



No output was produced because TYPE 17 and DEV X'lFO' are mutually exclusive. Type 17 (Parity Error) is a system 
class error while device X'lFO' implies that peripheral class errors are desired. Entering either MOD or DEV values 
precludes the display of any system errors (only peripheral class errors will have model or device address information, 
and all four boundaries tests -MOD, DEV, TYPE, and TIME -must be passed for an error log entry to be displayed). 



Example 11. Use of the MOD, DEV, and TYPE Commands 



The user next decided to examine SIO failures on several devices. 



*TYPE ,11© 

*DEV, 4, 81,82,83© 

♦CLIS© 



CHRONOLOGICAL LISTING 



TYPE =11 

DEV =0004 0081 0082 0083 

FROM 00/00/00 00:00:00:000 

TO 12/31/99 23:59:59:999 



*** SIO FAILURE *** 

I/O SIO- TDV- SUBC TDV CUR REM 

TIME MDL ADRS STAT CC STAT CC STAT COMM DA BYTES MFI 

12:36:30:782 7323 0083 2000 6 1000 6 00 0011B7 0001 00 

12:37:29:518 7323 0083 2000 6 1000 6 00 0011B7 0001 00 

12:40:10:398 7323 0083 2000 6 1000 6 00 0011B7 0001 00 
♦♦BREAK 
* 

After examining several of the failures on device X'0083', the user realized that no new information would be gained 
by listing the remaining errors. Therefore, the user interrupted the listing process by activating the BREAK key at the 
terminal. 
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Example 12. Use of the MOD, DEV, and TYPE Commands 



Finally, the user summarized, in graphic form, all Model 7322 and 7323 failures that occurred on the current day. 

*DEV,0© 
*TYPE,0© 
♦MOD, 7322, 7323© 
♦TIME, 00:00© 

♦DISP© 



GRAPHIC DISPLAY 



MODL =7322 7323 

FROM 02/09/74 00:00:00:000 

TO 12/31/99 23:59:59:999 



TIME ERROR 



09:11 11 

09:21 

09:31 

09:41 

09:51 

10:01 

10:11 

10:21 

10:31 

10:41 

10:51 

11:01 

11:11 

11:21 

11:31 

11:41 

11:51 

12:01 

12:11 

12:21 

12:31 



•10- 



•20- 



■30- 



1516151516161115151616 
1315161516 



1516 



END OP FILE 



DSPL The DSPL command displays the current state of 

those ELLA parameters that are alterable by the boundary 
commands. The date and time boundaries are always listed 
by this command. Each of the remaining boundaries will 
also be listed unless its current state is its default state. 

The DSPL output is printed both on the output listing device 
and the command input device. In batch operation, DSPL 
output is only directed to the output listing device since 
the input device is the card reader. 

The format of the command is 

ds[pl] 

An example of the command is given in Example 13. 



PREDEFINED TASKS 



This section contains a set of predefined tasks that should 
be useful to the person who needs periodic error log reports, 
but has no need for a more precise knowledge of the ELLA 
processor's command structure. These tasks could be main- 
tained as job decks (as illustrated here), or the commands 
might be entered into a file to facilitate on-line submission 
to the batch stream (see the TEL BATCH command in the 
CP-V/TS Reference Manual, 90 09 07). The account from 
which these jobs are run must have a diagnostic privilege 
level (A0 or higher). The tasks are listed in Examples 14 
through 16. 
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Example 13. Parameter Display 



The on-line user may check the current state of the ELLA boundaries conveniently with the DSPL command. If the 
listing device has been assigned to a line printer, the boundary information will be displayed on both the line printer 
and the user's terminal. 



*RSET © 

*SET,LIST,LP© 

*DSPL © 

FROM 00/00/00 00:00:00:000 



TO 12/31/99 23:59:59:999 

*TYPE,11,12,15© 

*DEV,E1© 

*DSPL© 

TYPE =11 12 15 

DEV=00E1 

FROM 00/00/00 00:00:00:000 

TO 12/31/99 23:59:59:999 



Example 14. Listing the Entire Error File 



The following deck obtains an error summary and a chronological listing of the entire contents of the error file. 



!FIN 



END 



CLIS 



SUM 



SELLA 



! JOB account, name, priority 
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Example 15. Listing Errors for the Current Day 



The following job deck obtains an error summary, a chronological listing, and a sorted listing of the errors recorded 
by the system on the current day. If error log reports are to be obtained daily, it is recommended that this job be run 
at the end of the processing day. 



!FIN 



END 



SLIS 



CLIS 



SUM 



TIME, 00:00 



!ELLA 



! JOB account, name, priority 



Example 16. Listing Start-Ups, Configuration, and Device Partitioning Activity 



The following job deck obtains all the configuration data together with system start-up, partitioned resource, and 
returned resource entries in chronological order. 



!FIN 



END 



CLIS 



TYPE, 18,21,22,51,52 



IELLA 



! JOB account, name, priority 
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ELLA MESSAGES 



ELLA COMMAND SUMMARY 



Messages output by the ELLA processor are listed in 
Table 36. 



ELLA commands are summarized in Table 37. The left-hand 
side lists the command formats. The right-hand side de- 
scribes the function of the command. 



Table 36. ELLA Messages 



Message 


Meaning 


ABNORMAL ERROR CODE = xx 
SUBCODE = xx 


An abnormal condition was detected in issuing a system CAL. 
The abnormal code and subcode are described in the CP-V/BP 
Reference Manual, 90 17 64, (and the CP-V/TS Reference 
Manual, 90 09 07). See the system analyst. 


BREAK 


The BREAK key was depressed. ELLA stops processing and waits 
for a new command. 


ELLA 708006- A00 


This heading is output when ELLA is first loaded. 


ERRFILE IS BUSY, WILL TRY AGAIN 


ELLA tried to access the error log file and found it busy. 


**ERRLOG NON-EXISTENT 


The ERRFILE file does not exist. See the system analyst. 


ERROR IN KEY FORMAT 

(YEAR/DATE NOT IN PACK DECIMAL) 


An ERRFILE entry had an erroneous key. See the system analyst. 


ERROR IN SYSTEM TIME 


The time in the error log file was not logical. See the system 
analyst. 


ERROR OCCURRED: CODE = xx 
SUBCODE = xx 


An error was detected in issuing a system CAL. The error code 
and subcode are described in the CP-V/BP Reference Manual, 
90 17 64, (and the CP-V/TS Reference Manual, 90 09 07). See 
the system analyst. 


ERROR: TIME . GT. 
99:59:59:999 


The time in an error log entry was greater than 99 hours, 59 
minutes, 59 seconds, or 999 milliseconds. See the system analyst. 


ERROR: TOO MANY CHARACTERS OR 
LINES 


ELLA tried to output more than 132 characters to the line printer. 
See the system analyst. 


INSUFFICIENT PRIVILEGE LEVEL ABORT 


ELLA requires an A0 or higher privilege level. 


INVALID REQUEST 


The command entered was invalid. 


NON-REASSIGNABLE 


Once the operator's console is assigned as the control device, it 
cannot be reassigned. 


NOTHING IN ERRFILE 


ERRFILE does not contain any records. 


**OVERFLOW OF SORT OR MOD/IO 
TABLES 


ELLA will only support 50 unique I/O addresses. Use the 
boundary commands to restrict the number of I/O addresses. 


UNABLE TO LOAD SEGMENT = nn 


ELLA tried to load overlay number nn and an error was detected. 
See the system analyst. 
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Table 37. ELLA Command Summary 



Format 


Description 


C[LIS] 


Requests a chronological listing of the error entries in the order 
in which they appear in ERRFILE. 


DE[v],f°.. r „ .] 
u ' laddress ,[,..., address-] J 


Selects error log entries for display by specifying up to five 
physical device I/O addresses or (if is specified) specifies that 
error log entries for all devices are to be displayed. 


Dl[SP][, interval] 


Requests a graphical display of error log entries. 


DS[PL] 


Displays the current state of the four types of boundaries. 


E[ND] 


Terminates ELLA and exits to the monitor. 


M[0D] ' {model ^...^modeg} 


Selects error log entries for display by specifying up to five model 
numbers or (if is specified) specifies that error log entries for all 
models are to be displayed. 


R[SET] 


Resets all boundary parameters to their default values. 


SET, LIST, {^ p } 


Reassigns the listing and message output device assignment during 
execution of ELLA. LP specifies line printer. KP specifies oper- 
ator's console for the ghost and batch modes and on-line terminal 
for the on-line mode. 


SL[IS] 


Requests a sorted listing of the error log entries. 


SU[M] 


Requests a summary of the contents of the error file which lists 
the total number (in decimal) of error log entries for each error 
type. 


Tl[ME][,begin][-end] 


Sets both the date and time boundaries where begin and end have 
the form 

[month/day/year][, hour:minute] 

or 
[houNminute]^ month/day/year] 


^Mtype^,... type 5 ]l 


Selects error log entries for display through the specification of 
error record type codes (see Table 33) or (if is specified) 
specifies that all types are to be displayed. 



HARDWARE-ERROR DIAGNOSTIC CALS 



The following three CALs are intended for use by the monitor 
in performing diagnostic functions relating to the hardware- 
error log and must be issued by a program from the :SYS 
account. They provide the following services: reading from 
the hardware-error log, writing to the hardware-error log, 
and initiation of diagnostic ghost jobs. 



These three services are all invoked by a CAL1,6 fpt in- 
struction; the addressed FPT contains a code and a parameter. 
The FPT codes and the functions performed are as follows: 



FPT Code 


1 
6 



Function 

Read Error Log 
Write Error Log 
Initiate Ghost Job 
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The status of the requested operation is reported via 
condition-code settings summarized below. (Not all of the 
status indicated are appropriate to, or reported by, all 
three CALs.) 

CC1 CC2 CC3 CC4 Status 

Normal return. 

•1 Request denied: insufficient privi- 

lege, not in :SYS account, or buffer 
is not a data page. 

10 Error during operation (Read or 

Write), or job unknown (Initiate). 

10 Last buffer. 

1 Error log does not yet exist (Read). 

In each case, the calling program must be of privilege level 
CO or greater; otherwise CC1 is set to 1 and no action is 
taken. 

READ ERROR LOG 

The format of the FPT for a read-error- log request is 



X'00' 



1 2 314 5 6 7T8 9 10 1U12 13 14 15 



fffl! 



Buffer address 



16 17 18 19120 21 22 23124 25 26 27128 29 30 31 



A variable number of words up to a maximum of 256, de- 
pending upon the contents of the error log, is read to the 
area addressed by the FPT. This is a 'destructive' read, 
returning error- log granules to the monitor's available pool 
as they are exhausted. 

The error- log file is not protected against simultaneous use; 
thus only one program in the entire system should read this 
file. 



WRITE ERROR LOG 

The format of the FPT for a write-error-log request is 



X'OT 



1 2 374 5 6 7 



TTl2 



9 10 111 12 13 14 15 



Buffer address 



16 17 18 19120 21 22 23124 25 26 27T28 29 30 31 



The second byte of the data record addressed by the FPT 
must specify the number of words to be written, up to a 
maximum of 253. The first byte of the record should con- 
tain a type code. 



INITIATE GHOST JOB 

The format of the three-word FPT for an initiate-job request 
is 

word 



X'06' 



0- 



-0 



i 2 3~1"4 5 6 7 I 8 9 10 llll2 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



words 1 and 2 


(Name of job to be initiated) 






n 


a l 


a 2 


a 3 


n-3 


a n-2 


a n-l 


a 
n 


1 2 3 1 4 5 6 7 


8 9 10 111 12 13 14 15 


16 17 18 19l20 21 22 23 


24 25 26 27I28 29 30 31 



(Name of job must be in TEXTC format.) 

If the program to be initiated is already in execution at the 
time of the request and is not in a waiting state (WAIT CAL 
with unexpired time), the normal return is made (CCI=0). 
If the program is in a waiting state, it will be activated 
immediately at the WAIT CAL plus 1 and a normal return is 
made to the initiating program. 
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7. SHARED PROCESSOR FACILITIES 



INTRODUCTION 

This chapter describes the shared processor facilities of 
CP-V. These facilities permit the sharing of the code for 
compilers, assemblers, command language processors, de- 
buggers, libraries, and other programs among all simulta- 
neous users. 

Shared processors are not limited to programs provided 
by Xerox. The facilities may be effectively used when- 
ever a program has a high probability of common usage. 
Service bureaus, for example, may use the mechanism for 
proprietary packages. Corporate installations may use the 
mechanism for programs with a high use frequency. 

Most programs may be establ ished as shared processors by 
naming them at SYS GEN time. This causes the file copy 
of the program from the :SYS account to be written on the 
swapping disk during system initialization. The program is 
then available through high-speed swapping I/O. 

The file copy of the program is retained for recovery pur- 
pose! and may be copied to another account and run as an 
unshared program under Delta for development and debug- 
ging purposes. If the load module in the :SYS account is 
replaced, the shared copy of the program on the swapping 
disk is updated to the newer version in the event of a sys- 
tem recovery. 

To qualify as a shared processor, a program must meet cer- 
tain requirements. These requirements are outlined in the 
remainder of this chapter. The most stringent requirement 
relates to the single overlay level that is described in the 
section below titled "Overlay Restrictions". 

To avoid confusion, the use of processor names which re- 
semble monitor mnemonics is discouraged. However, if such 
names are used, the following rules must be followed: 

1 . If the first three characters of the processor name are 
JOB, BIN, BCD, EOD, or FIN, then usage of that pro- 
cessor in the batch mode requires that at least one blank 
appear between the ! and the processor name on the 
control command which calls the processor. 

2. The names of monitor control commands (listed in the 
CP-y/BP Reference Manual, 90 17 64) are reserved words 
and must not be used as processor names. 



PUBLIC PROGRAMS 

A program whose load module is in the :SYS account but is 
not shared is a publ ic program in the sense that it may be 
called either by a control card containing the ! symbol and 
the program name, or by an entry of the program name in 
response to a TEL prompt (!) for commands. Each user of a 
public program has his own copy of the program. 



PROCESSOR PRIVILEGES 

Processors in the :SYS account and shared processes may be 
granted special privileges which are independent of the 
user's privilege level and are in effect only when the pro- 
cessor is executing. For shared processors, privileges are 
specified on the :SPROCS command at SYS GEN or on the 
DRSP command which enters the processor. Privileges for 
unshared processors are specified when the load module is 
loaded, using the PRIV keyword. The privilege flags be- 
come part of the load module and are invoked when the 
load module is executed. Load module privileges will not 
be granted by the monitor unless the load module resides in 
the :SYS account when it is executed. 

The following privileges are implemented: 

1. Master mode permission — can execute M5YS or 
M:MASTER CALs. 

2. Maximum memory protection — can exceed user's 
memory limit to a maximum of 92K words. 

3. Special JIT access — allowed write access for JIT page. 

4. Processor accounting— causes CPU time to be subtotaled 
separately from user execution and service time. It 
will be subtotaled as processor execution and service 
time. (This is always done for shared processors. ) 



SHARED PROGRAMS 

Shared programs are called in the same manner as public 
programs. However, each user of a shared program has his 
own copy of only the data and DCB portion of that program; 
the procedure portion is shared by all users associated with 
the shared program. 

There are four distinct kinds of shared programs: 

1 . Ordinary shared processors. 

2. Special shared processors. 

3. Shared debuggers. 

4. Public libraries. 

All shared processors must be built by the batch loader. 
Ordinary shared processors occupy the same virtual memory 
as user programs and may not be associated with them. 

Special shared processors, shared debuggers and public li- 
braries occupy (and are overlayed in) the special processor 
area. Figure 11 shows the virtual memory allocation for 
shared programs that are biased within the special processor 
area. Shared debuggers may be associated only with user 
programs; they may not be associated with any other shared 
processors. Public libraries may be associated with user 
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Figure 11. Special Processors — Virtual Memory 



programs or ordinary shared processors; a public library may 
not be associated with a special shared processor. Note 
that both a shared debugger and a core I ibrary may be con- 
currently associated with a user program. This is possible 
because the procedure portion of the debugger and the 
library may be overlayed in the special processor area. 



LOG-ON CONNECTION 

Commonly used programs, such as BASIC, may be called 
automatically by LOGON. The name of the program to be 
called, which maybe either a shared or public program from 
any accessible account, is established in the user's author- 
ization record by Super. LOGON calls the named program 
for the user following a successful log-on. 



SHARED PROCESSdR PROGRAMMING 

The programming of shared processors may require certain 
information about the CP-V monitor. This information is 
outlined below. 



FIXED MONITOR LOCATIONS 

For certain purposes, such as the choice of an effective core 
allocation technique, it is desirable for processors and other 
programs to be able to identify the monitor in operation, 
certain critical locations of the monitor, and the location 
of job information table (JIT). This is accomplished by 
having locations 2A, 2B, and 4F common to all Xerox mon- 
itors. Figure 12 illustrates the contents of these locations. 

Location 2A contains a flag that differentiates between an 
initial boot (nonzero) and a recovery boot (zero). 

Location 2B contains three items: 

1. Monitor — This field contains the code number of the 
monitor. The codes are as follows: 

Code Monitor 






None or indeterminate 


1 


BCM 


2 


RBM 


3 


RBM-2 


4 


BPM 


5 


BTM/BPM 


6 


UTS 


7 


CP-V 


8 


CP-R 


9-F 


Reserved for future use 



2A 


Boot Flag 




1 2 jl 4 5 6 7 1 B 9 10 111 12 13 14 wl 16 17 18 19I2O 21 22 23 1 24 25 26 27 1 28 29 30 31 


2B 


MONITOR 




Version 


Parameters 




01 2 31 


4 5 6 7 


8 9 10 lit 12 13 14 15 


16 17 18 19l20 21 22 23l24 25 26 27I28 29 30 31 


4F 


Wf x > 


J IT Address 




1 2 31 


4 5 6 7 


8 9 10 111 12 13 14 15 


16 17 18 19120 21 22 23124 25 26 27l28'29 30 31 



Figure 12. Locations Common to All Monitors 
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2. Version — This is the version code of the monitor and is 
coded to correspond to the common designation for 
versions. The alphabetic count of the version desig- 
nation is the high-order part of the code and the version 
number is the low-order part. For example, A00 is 
coded X'10' and D02 is coded X'42\ 

3. Parameters — The bits in this field are used to indicate 
suboptions of the monitor. They are meaningful only 
In relation to a particular monitor. However, the fol- 
lowing assignments have been made for BPM, BTM, 
and CP-V. 



Bit(s) 
31 set 
30 set 

29 set 
28 set 
27 set 

26 set 



Meaning 

Symbiont routines included. 

Remote processing routines 
included. 

Real-time routines included. 

Unused. 

Reserved for Data Manage- 
ment System. 

Reserved. 



22, 23, 24 reset; 25 set Computer is Sigma 6 or 7. 
Computer is Sigma 9. 



22, 23 reset; 24 set; 
25 reset 



22, 23 reset; 24 set; 
25 set 

18 set 



17 set 



16 set 



Computer is Xerox 560. 

Multiprocessing capability 
present. 

Transaction processing rou- 
tines included. 

On-line system. 



Location 4F contains the virtual JIT address right-justified. 



| JOB INFORMATION TABLE (JIT) 

i 

For each active job, the system maintains an in-core record 
(job information table) that allows the job to be scheduled 
and swapped. This job information table (JIT) is the first 
page of each job, both in core and on the swapping disk, 
and contains accounting information, memory map, swap 
storage, addresses, and other information for the job that 
may be of use to a processor. *" In order to reference these 

With respect to accounting, only shared processors or load 
modules with the "processor accounting" privilege are pro- 
cessors, i.e., time spent compiling a COBOL program is 
accounted under "user time" while time spent in FORTRAN, 
PCL, etc., is considered "processor time". 



values, the processor should REF the required symbol and 
then specify that :J0, the JIT definition package, be loaded 
along with the processor. The entire JIT is available on a 
read-only basis to all programs including processors. Con- 
tents that are particularly useful to processors are given in 
Table 38. The complete contents are described in the CP-V 
Data Base Technical Manual, 90 19 95. 



Table 38. Partial Contents of JIT 



Location 


Size 


Contents 


J:JIT 






(bit 0) 


1 bit 


Set if the job is on-line and 
reset if the job is batch. 


(bit 1) 


1 bit 


Set if the job is a ghost job. 
For example, the meaning of 
bits and 1 is as follows: 

00 batch job 

01 ghost job 
10 on-line 


(bit 2) 


1 bit 


Set if user is a non-COC 
on-line user. (Bit also 
set.) 


(bit 3) 


1 bit 


Reserved . 


(bit 4) 


1 bit 


User is executing from a 
command file. 


(bits 
16-31) 


halfword 


Job identification number 
that is guaranteed to be uni- 
que to each currently exe- 
cuting job. 


JB:LPP 


byte 


Number of printable lines 
per page (COC). 


JB.-LC 


byte 


Current print line number 
(COC). 


J:OPT 


word 


Option flags set by TEL and 
affected by the 'DONT' 
modifier. 


JrCCBUF 


20 words 


Image of the command line 
received by TEL. 


JBrCCARS 


byte 


Length of command line 
received by TEL. 


JrUSER 


2 words 


On doubleword boundary for 
any use by installation. 


M:UC 


22 words 


Console I/O DCB (system 
DCB). 
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MEMORY CONTROL 



I DATA CONTROL BLOCKS 



No special memory restrictions apply to programs operating 
as shared processors. In CP-V, as in any other time-shared 
or multiprogrammed system, prudent use of memory can sub- 
stantially improve system throughput. Requests for all avail- 
able memory should be avoided. A request for enough 
memory to cover typical processing shouldbe made initially, 
then a request for additional memory should be made during 
processing if the need arises. Memory should be returned to 
the system at major changes of contro! , but the frequent 
acquisition and release of memory will increase system over- 
head out of proportion to the gain. 



OVERLAY RESTRICTIONS 

Any processor intended for shared use may be created and 
debugged as an ordinary program. It may be coded in as- 
sembly language and debugged under Delta or created in 
FORTRAN and debugged with FDP. To qualify for inclu- 
sion as a shared processor, it must be coded within the 
following restrictions: 

1. Shared processors are allowed only one level of over- 
lay. There is no restriction on the number of overlays 
but only one of them can be associated at a time. 

2. Data cannot be included in overlays; it must be in the 
processor root. 

3. Overlay names are restricted to seven characters or 
less. 

4. All parts of an overlay disappear from core when an- 
other overlay is called. (Portions of a previously used 
overlay are not available when a shorter overlay is 
invoked. ) 

5. Shared processors written in FORTRAN must be pre- 
ceded by some Meta-Symbol code that associates the 
library and links to the FORTRAN code. 

6. The root must be greater than one page in length. 

When an overlayed shared processor is requested, the pro- 
cessor root and its first overlay are loaded. Assembled data 
and DCBs are loaded when the root is loaded. Whenever 
overlays are not required, memory usage can be held down 
by declaring an overlay length of zero and issuing a CAL to 
associate that overlay. 

Overlays are declared and associated in the same way as 
they are for batch programs (CP-V/BP Reference Manual, 
90 17 64). TREE command cards and M:SEGLD remain the 
same. CSECT 2 and 3 are converted to CSECT 1 by CP-V 
loaders. 

Shared debuggers (Delta is the only current example) must 
have only one page of context and no overlays. They re- 
side in the special virtual area of high memory that is cur- 
rently fixed in virtual (not physical) size in the highest 
16K of virtual storage. They may be any physical size less 
than 16K including their context page. 



Most processor I/O operations are performed through stan- 
dard monitor DCBs. For example, source input is norm- 
ally read by 

M:READ M:Sl[options] 

The standard DCBs are 
M:BI 
M:CI 
M:EI 
M:SI 
M:C 
M:BO 
M:CO 
M:DO 
M:EO 
M:LO 
M:SO 
M:PO 
M:AL 
M:LL 
M:OC 
M.-SL 
M:GO 



The default assignment of monitor DCBs is the operational 
label of the same name (M:DO is assigned to DO, etc.). 
The default assignment of operational labels to devices is 
shown in Appendix A. These assignments may be changed 
at SYSGEN. The default assignments for batch operations 
differ from those of on-line operations. This is done so that 
a program that writes through LO and reads through SI will 
automatically use the line printer and card reader for batch 
operations and the terminal for on-line operations. The 
logical functions associated with the operational labels are 
described in the CP-V/BP Reference Manual, 90 17 64. 



Details concerning input buffers, error handling, and so on 
are specified as parameters in a read or write call. Param- 
eters associated with files and devices are specified by the 
ASSIGN (batch) or SET (on-line) control command. 
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A processor may construct its own DC Bs by means of the 
M:DCB procedure. However, processors are not required 
to construct DCBs. DCBs not constructed by a processor 
will be constructed by the loader. Standard DCBs con- 
structed by the loader occupy 51 words and are connected 
to a device either by the loader or by an on-line user by 
means of special terminal commands. The M:DCB procedure 
must be used if optional parameters such as read or write 
accounts exceed the allocation of the standard DCBs 
(Table 39). 

DCBs are also provided in library form and may be explicitly 
called during a load. The sizes of these DCBs are shown in 
Table 39. 

Processors may use nonstandared DCBs, if necessary. Non- 
standard DCBs are constructed by the loader if not con- 
structed by the processor. They must be explicitly connected 
to a device either by an M:OPEN call in the processor or 
by a SET command issued by an on-line user since no default 
assignment via operational labels is provided. 

It is common practice for a processor to obtain source input 
through M:SI, to print a source listing through M:LO, and 
to print diagnostic output through M:DO. However, pro- 
cessor I/O operations are complicated by the fact that an 
on-line user can connect SI, LO, and DO either to different 
devices or to the same device (the on-line default assign- 
ment for SI, LO, and DO is the terminal). In particular, a 
user may connect two or more of these standard operational 



labels to the same device. For this reason, processors must 
take precautions to avoid duplications in printed output. 
This means that processors must know at all times whether 
they were called in batch or in on-line mode and what 
specific device connections have been made for standard 
DCBs. 

Processors may examine DCBs directly to determine when 
the DCBs are connected to the same device. Fields within 
a DCB may be referenced relative to the name of the DCB. 
Fields that may be useful to processors are as follows: 

Field Use 

FCD Bit 10 of word of a DCB. This is the file- 

closed flag. A 1 means the associated file 
is open; a means the file is closed. 

TYPE Bits 18-23 of word 1 of a DCB. These bits 

specify a code for the type of device con- 
nected to the DCB (printer, terminal, card 
reader, etc. ). 

DEV Bits 24-31 of word 1 of a DCB. These bits 

specify an index to the monitor device table. 

Under CP-V, all device assignments are direct. This means 
that DEV always contains a direct device assignment. A 
complete layout and description of DCBs is contained in the 
CP-V/BP Reference Manual, 90 17 64. 



Table 39. Standard DCBs 



Name 


Device 


Name 


Account 


Pass- 
word 


Expiration 
Date 


Read 
Accounts 


Write 
Accounts 


Execute 
Accounts 


Execute 
Vehicle 


INSNS 


OUTSNS 


S/non/mous 
Name 


Key 
Buffer 


Total 
Words 


Loader 

Built 

DCBs 


22 


4 


3 


3 


3 












4 


4 





8 


51 


M:C 


22 


























22 


M:OC 


22 


























22 


M:BI 


22 


9 


3 


3 


3 










4 






8 


52 


M:CI 


22 


9 


3 


3 


3 










4 






8 


52 


M:SI 


22 


9 


3 


3 


3 










4 






8 


52 


M:EI 


22 


9 


3 


3 


3 


17 


17 


17 


4 


4 




9 


8 


116 


M:BO 


22 


9 


3 


3 


3 


17 


17 






4 






8 


86 


M:CO 


22 


9 


3 


3 


3 


17 


17 






4 






8 


86 


M:SO 


22 


9 


3 


3 


3 


17 


17 






4 






8 


86 


M:PO 


22 


9 


3 


3 


3 










4 






8 


52 


M:LO 


22 


9 


3 


3 


3 










4 






8 


52 


M:LL 


22 


9 


3 


3 


3 










4 






8 


52 


M:DO 


22 


9 


3 


3 


3 










4 






8 


52 


M:GO 


22 


9 


3 


3 


3 
















8 


48 


M:EO 


22 


9 


3 


3 


3 


17 


17 


17 


4 


4 




9 


8 


116 


M:SL 


22 


4 


3 


3 


3 
















8 


43 


M:AL 


22 


4 


3 


3 


3 
















8 


43 
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The same effect can be obtained by the CORRES device 
CAL, but the CAL is much slower than the direct compar- 
ison. The direct comparison of the combined TYPE-DEV 
fields is meaningful only if the DCB has been opened. This 
means that processors must explicitly open DCBs for which 
device assignments will be tested. 



FILE IDENTIFICATION | 

All on-line processors use a common format and common 
character set for constructing file identifiers (fid). The 
standard format is 






. account "I 

account, password 
password J 



where name, account, and password consist of character 
strings with maximum lengths of 11, 8, and 8, respectively 
(name has a maximum of 13 characters for CO, Edit, and 
PCL and a maximum of 10 characters for Link and Load). 
Any of the following characters may be used: 



A-z 



0-9 



% 



Lowercase alphabetical characters are not available on all 
terminals (e.g., Teletype Models 33 and 35). If lowercase 
letters are sent to these terminals, they are printed in upper 



case. 



Account and password are optional. If account is omitted, 
the log-on account is the default account. If password is 
omitted, no password is required to access the file. 



TEL SCAN 

A processor call entered through a terminal via TEL has the 
form 



SR 1 [OVER t rom ][r llst ]J 



where 



Im is the name of the processor and is a file identi- 

fication (fid). Account :SYS is assumed. 

sp specifies a source program and may be either a 
file identification (fid) or a terminal identifica- 
tion (ME). 

ON indicates that ROM output is to be on a new 

file. 

OVER indicates that ROM output is to be over an 

existing file. 



rom specifies that the relocatable object module 
produced by the processor is to be directed to a 
specified file (fid). If no file is specified, out- 
put is directed to a special file that may be sub- 
sequently referenced by a dollar sign. 

list specifies that a file (fid), a line printer (LP), 
or the terminal (ME) should be used for listing. 
If list is not specified, no listing output is 
produced. 

These specifications are implicit ASSIGN and SETcommands 
for the DCBs M:SI, M:GO, and M:LO. A processor call 
causes the specified processor to be executed with M:SI DCB 
input from the file sp. Processor output through M:GO DCB 
is placed in the file specified by "rom" and listing output 
(M:LO DCB) is directed to the file or device specified 
by "list". Processor calls are interpreted by TEL. 

Parts of a processor call may be enclosed in parentheses. 
TEL does not do anything to these parts of a processor call. 
However, the processor may examine these and other parts 
of the command line that is in its JIT buffer (JrCCBUF). 

Processors may reside in storage in three forms: 

1. System swap storage contains absolute shared copies 
of frequently-used processors. These copies can 

be located and loaded quickly. The absolute shared 
processor file is created during system initialization and 
contains reentrant processors that are shared among 
all concurrent users. 

2. The :SYS account may also contain copies of processors 
in load module form. Processors in this form cannot be 
loaded as quickly as absolute processors, but the :SYS 
account may be useful during processor construction, 
debugging, and extension. Public programs in the 
:SYS account may be called by entering their names in 
TEL commands or on control cards. 

3. A user may store his own processors or his copies of 
system processors in his own files (account). A pro- 
cessor stored in a user's file area is identified by its 
file name and may be called by the RUN command 
in batch or START command in on-line operations. 



When TEL encounters a processor call, it issues an exit CAL 
specifying the requested processor. The monitor routine 
STEP checks to see if this user has any processor restrictions. 
If the user is not restricted from using the requested pro- 
cessor, STEP checks to see if the processor is a shared pro- 
cessor. If it is shared, STEP checks to see if the processor 
is in core. If it isn't in core, STEP loads it into core. If 
the processor is not shared, STEP searches the :SYS account 
and loads the processor from there. If the processor cannot 
be found, an error message is sent to the terminal. Before 
control passes to the processor, TEL checks the parameters of 
the processor call for correct syntax and for existence of the 
"sp" file and a "rom" or "list". 
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TEL sets and resets bits in JIT to correspond to the commands 
LIST, DONT LIST, etc., and to the initial occurrence of 
assignments in the command string. One JIT word (J:OPT) 
contains a bit for each option that can be specified for a 
processor. The options and their corresponding bit assign- 
ments are as follows: 



Identifier 


Bit 


Set 


Reset 


LO 


31 


LIST 


DONT LIST 


GO 


24 


OUTPUT 


DONT OUTPUT 


DO 


23 


COMMENT 


DONT COMME 


- 


15 


DEBUG 


DONT DEBUG 


— 





ECHO 


DONT ECHO 



The underlined values are default values. The default 
setting for J:OPT is STDOPT in the monitor root (module 
LITERALS). This cell may be patched by the installation to 
generate different defaults than are indicated in the pre- 
ceding table. If a SET command is issued for the M:LO, 
M:GO, or M:DO DCB, or the list output or binary output 
fields are specified in a TEL command, the corresponding 
bits are set. Each processor must assign meaning to the bits 
in J:OPT and interpret them. Unassigned bits are available 
for future use. Checks of these bits should be made on each 
write command since TEL allows on-line users to interrupt 
the processor and turn on or off the LO, GO, and DO 
devices. 

Each processor should establish conventions to maintain 
orderly output when two or more DCBs are connected to the 
same device. The usual convention is that if diagnostic 
output has been written via M:LO, and M:LO and M:DO 
are connected to the same device, then the diagnostic out- 
put should not be written via M:DO. The following ex- 
ample illustrates some of the special cases that processors 
should consider: 

1. M:SI, M:DO, M:LO connected to the same device 
(the input line should not appear three times). 

2. M:DO connected to a device that is different from SI 
and LO (the diagnostic comment should probably be 
printed beneath the line in error). 

3. M:SI and M:DO connected to a Teletype (processors 
may or may not want to type a line in error). 

Processors may read each input image via the M:SI DCB. 
The last record of the sp will cause an end-of-data abnor- 
mal condition (see the CP-V/BP Reference Manual, 90 17 04 
for a description of abnormal conditions). To obtain con- 
trol of an error or abnormal condition, a processor must 
issue the MrSETDCB command and/or include error and ab- 
normal exits in its read and write CALs. Since source input 
may come from a Teletype (sp = ME), processors must be 
able to handle Teletype input. The problems associated 
with Teletype I/O are discussed in the section on terminal 
I/O. 



CCI SCAN 

On transferring control to a user's program or to a processor, 
the monitor communicates the TCB address via general reg- 
ister 0. Processors may fetch the card image of the command 
that called them by reading through a DCB connected to the 
C device. 

When running in batch mode, the processor must read the 
C device once to clear the control command. The com- 
mand is transferred to the user's buffer to allow the user's 
program to examine parameters. 



TERMINAL I/O 

An on-line user may direct output to his Teletype at any 
time during execution of a processor. Similarly, portions 
of the input to a processor may come from a Teletype. In 
general, Teletype I/O is the same as other J/O in its use 
of M.-READ and M:WRITE operators and the standard abnor- 
mal and error situations. However, Teletype I/O has some 
features that are significantly different from those for other 
devices. Some of the differences require special attention 
by processors, but the interface is designed in such a way 
that processors will not have to know whether or not I/O 
operations are via Teletype, providing they observe certain 
conventions. On terminal I/O, like all I/O, the user 
should note that byte displacements in the DCB remain in 
effect until replaced, once they have been given. The 
special problems associated with Teletype I/O are outlined 
in the following paragraphs. 

END CHARACTERS 

On input from a Teletype, each record read is terminated 
by an end character (CR, FF, LF, RS, US, FS, GS). The 
end character, if any, is included in the actual record 
size (ARS) count reported in the DCB (bits 0-14 or word 4). 
Each processor must interpret the different end characters. 
Processors do not have to know that input is via Teletype, 
provided they treat these characters as terminators and use 
ARS to determine the actual record received. 

Source files for all processors, including those in batch 
operations, may have been prepared on-line. Since records 
prepared on-line are variable length, it may no longer be 
assumed that input records are 80-byte card images. 

All characters received from terminals, no matter of what 
type, are translated to the standard EBCDIC character set. 
The hexadecimal codes for EBCDIC characters are listed 
in Appendix H. 

WRITE OUTPUT 

The length of each output line is specified by the SIZE 
parameter in the MrWRITE procedure call. It is terminated 
only by the character zero. That is, the user may term- 
inate a message with a zero character if he wishes and 
the COC routines will compute the proper message length. 
Carriage return or new line characters do not terminate 
a message. 
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CARRIAGE RETURN 



OTHER ABNORMAL CONDITIONS 



A new line or carriage return sequence, as appropriate to 
the type of terminal, is appended to the character string 
supplied by each write under the following circumstances: 

1. The DCBis not M:UC. 



If unknown operations are requested of the COC routines 
(e.g., write end-of-file), the abnormal code for beginning- 
of-tape will be returned. If there is no abnormal address, 
the operation will be ignored. 



2. The suppress space option is not specified. 



Thus, under ordinary circumstances, carriage return char- 
acters will be supplied when output consists of one line per 
write and the DCB is connected to a terminal. By using the 
suppress space option or by writing through M:UC, the pro- 
gram may supply carriage returns exactly to requirements — 
either none or several for each write CAL. 



PARITY ERRORS AND LOST DATA 

When an M:READ CAL specifies a terminal, any character 
received with a parity error is replaced by SUB (USASCII 
code 1A) and the lost data abnormal code (07) is returned 
to the user if an abnormal address exists. If there is no 
abnormal address, control proceeds to the CAL plus 1. 
The line is returned to the user's buffer and the program 
may expect to encounter the SUB code as it scans. 



In designing a response to messages that contain parity error 
characters, two facts are important: 

1. The user has already been informed of the error by the 
COC routines that echo the exact bits received on the 
line followed by the * character. 

2. If the received image is sent back to the terminal to- 
gether with an error message, the ^ character will be 
printed when SUB codes appear. 



In the absence of special considerations unique to the pro- 
cessor, it is recommended that lines received with lost data 
be sent back to the terminal together with the comment 
"EH?". This procedure is helpful as an aid in diagnosing 
faulty terminals and communication lines. 



END-OF-FILE 

If the user types the character pair ESC F, an end-of-file 
abnormal code will be returned to the program reading the 
terminal at the abnormal address (if there is one). An input 
line that contains all characters received prior to the end- 
of-file sequence will also be transmitted to the user's buf- 
fer. This line is always terminated with a carriage return 
which is also sent to the user's terminal. If no abnormal 
address is specified, the line appears as an ordinary input 
line. If both bad data and end-of-file occur in the same 
input, then the bad data is reported. 



FORMAT CONTROL 

COC routine action for the various formatting CALs is 
specified in the CP-V/TS Reference Manual, 90 09 07. It 
is briefly reviewed below. 

It is sometimes necessary to print a line with special spacing 
or without a carriage return. Processors can obtain verti- 
cal carriage control by means of two parameters (SPACE 
and VFC), both of which can be set by the DEVICE CAL. 
The SPACE and VFC parameters have the following inter- 
pretations for Teletypes. 



Parameter Meaning 



SPACE 



VFC 



If this parameter is set and VFC is not on, the 
number of spaces indicated minus 1 is in- 
serted before each write. Counts of and 1 
result in single spacing. 

If this flag is set, the COC routines simulate 
the printer's vertical format control as speci- 
fied in the first character of the text lines 
written. The simulation is limited to one of 
the following cases: 



Hex. Code 



Cl-CF 



FT 



60, E0 



Action 

COC inserts 1-15 spaces be- 
fore printing. 

COC skips to top-of-page by 
skipping six lines and printing 
the heading information fol- 
lowed by the print line. 

COC does not insert CRLF 
after the print line (suppress 
space). 



For page control, COC routines count the number of lines 
transmitted to and received from the user's terminal. New 
page headings are printed for every read or write when the 
line count exceeds the maximum specified in JIT (via the 
PLATEN command). New page headings are also printed if 
the user program issues a PAGE device CAL or if the termi- 
nal user types the FF character L c (CONTROL L). 

Information in the page heading may be specified by the 
user by means of the HEADfR and COUNT device CALs. 
Heading information is taken from the DCB through which 
the read or write was given. Thus, if a write call is issued 
to a Teletype through more than one DCB, the heading 
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printed depends upon the DCB through which the top line of 
the page was written. The automatic page heading occupies 
one line and contains current time, date, user name and 
account number, user identification and line number, page 
number, and possibly an administrative message. Headings 
specified in the DCB of the read or write are produced after 
the automatic heading with position, text, and page number 
as specified in the CP-V/BP Reference Manual, 90 17 64. 
The page count in this heading is that carried in the DCB 
and is reset with each COUNT device CAL. The page count 
for the automatic heading is carried in JIT and may be reset 
via theTEL PAGE command. The automatic heading is sup- 
pressed if the page length is less than eleven lines. Head- 
ings are also not printed if the automatic page heading is 
turned off via the TEL PLATEN command. 

Tab characters are replaced with an appropriate number of 
blanks in input lines. Tabs are notrequired in output lines. 
However, if a highly formatted output line is sent to the 
Teletype, the operation will be more efficient — and more 
satisfactory for the on-line user. Tabs are activated by in- 
serting a tab character (X'05')in the outputstream. Tabs may 
be sent directly to the terminal or simulated by the software 
as requested by the terminal user who may turn simulation 
on and off using the sequence © T. When simulated by the 
software, each tab character in the output stream causes 
insertion of spaces to move the carrier to the right of the 
next higher position specified in the DCB. 

Simulated tab stops can be set by a processor with the TAB 
device CAL or by an on-line user (for the M:UC DCB) with 
the TABS command. Tabs must be specified in ascending 
order beginning with tap stop position 1. Note that this is 
different from the line printer tabbing, where the tabs need 
not be in ascending sequence. Tab stops can be set at any 
time for any DCB. During output operations, tabs are 
expanded as specified by the DCB through which the write is 
issued or, if not specified there, as specified in the M:UC 
DCB. Tabs typed by an on- line user are simulated at the user's 
console according to the tab settings in the M:UC DCB. 

If the backspace character is typed at the terminal, the 
character is passed to the reading program. No special 
action is taken by the COC routines other than that neces- 
sary to record current carrier position (which for backspace 
depends on terminal type). Terminals that have a physical 
backspace may, at the user's option, use a "backspace-edit" 
mode for intra-line editing. (Reference: CP-V/TS Reference 
Manual, 90 09 07.) 

A program can request control when the user presses the 
BREAK key by means of the M:INT procedure. Whenever 
the user presses the BREAK key, the program environment at 
the time of the break is recorded in the user's pushdown stack 
in his TCB. Execution can be returned to the location fol- 
lowing the interrupted instruction byexecution of the M:TRTN 
procedure. A program can return break control to TEL by 
executing the M:INT procedure with a break routine address 
of zero. The break routine address is checked by the monitor 
to guarantee that the address lies within the memory allo- 
cated to the user. Even if a processor has obtained break 
control, an on-line user can return execution control to TEL 
by pressing the © © , © Y, or Y° keys. 



As a safety measure to protect the user against faulty pro- 
gramming in break control routines, the number of times the 
BREAK key is pressed by a user without intervening char- 
acters is recorded. When the count reaches four, control 
is sent to TEL as if Y had been pressed. Thus, the user at 
the terminal will never find himself locked out. The count 
of four allows processors (e.g., FDP) to make special inter- 
pretations on two and three breaks in a row. 



FILE EXTENSION 

File extension is a convention by which records are added 
to an output file by successive job steps. Each time the file 
is opened, the file pointer (tape, disk pack, etc.) is posi- 
tioned to a point immediately following the last record in 
the file. Thus, when additional output is produced it is 
added to the previous contents of the file, thereby extend- 
ing it. File extension simulates output to physical devices, 
such as line printers or typewriters, when output is actually 
directed to a file. 

File extension takes effect at the time CP-V opens system 
output DCBs. The output DCBs that are affected by file 
extension are those that are currently assigned to files, al- 
though normally assigned to devices. They include: M:LO, 
LL, DO, PO, BO, SL, SO, CO, AL, EO, and GO. 



File extension is discontinued when a file is reassigned 
with a SET or ASSIGN command or when a file is opened 
with an OPEN procedure call that specifies an explicit 
file name. In these cases, a new file is created. Exten- 
sion of the GO file is terminated following a LINK, LYNX, 
or RUN command. 



SHARED FILE USE 

Shared processors must ensure that temporary files used 
during operation are distinct for each instance of exe- 
cution. A common technique for accomplishing this is 
to append the current users ID, from the right half of the 
first word of JIT, to the filename when it is created and 
used. This ID is guaranteed by the system to be unique 
for all concurrently running batch or on-line programs. 
A discussion of shared files is contained in CP-V/BP Ref- 
erence Manual, 90 17 64. 



COMMAND PROCESSOR PROGRAMMING 

A command processor is a shared processor which inter- 
faces between the user and that which the user wants to 
access — the monitor, a processor, or another program. 
Four command processors are supplied with CP-V. They 
are LOGON, TEL, CCI, and EASY. CP-V will also 
support installation-specific command processors. Infor- 
mation about the programming of command processors is 
outlined below. 
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Generally, command processors have the same restrictions 
as listed for shared processors previously. In addition: 

1. A command processor may not have any overlay 
structure. 

2. A command processor which resides in the special pro- 
cessor area (above X' 1C0O0') may not have any dynamic 
data and must be biased at X'1C400'. 

3. A command processor must intercept all exits, errors, 
and aborts from user programs and must clean up cor- 
rectly. (Special CALs for command processors are 
listed below. ) 

4. Command processors should not be given special JIT 
access. (The special CALs for command processor in- 
terface eliminate the need for it.) 

5. When programs error or abort, control will be given to 
the command processor with the following restrictions: 

If the command processor resides in the user 
program area (X'AOOO 1 to X'lC000')or the user 
program is loaded in the extended mode (X'AOOO 1 - 
X 1 1FFFF'), the exiting user program will be com- 
pletely disassociated before associating the com- 
mand processor, eliminating the possibility of 
continuation of the job step. 

If the command processor resides in the special 
area (X 1 1C600' to X'l FFFF'), has no dynamic data 
or DCBs, uses only M:UC and M:XX, control will 
pass to the command processor with the user intact, 
allowing analysis of the exit and continuation of 
the current fob step. 

Command processors maybe entered into the system during 
PASS2 of SYSGEN by using the T, B, G, and C flags of 
the :SPROCS command. They may also be added to the 
system, replaced, or deleted from the system via the DRSP 
processor. 

The following capabilities are available to command 
processors : 

I . Interpretive Exit — An interpretive exit is a natural 
exit CAL (M:EXIT) performed by a command processor 
with the following register setup required. 

R6, R7 Contain the TEXTC name of the requested 

R8 load module or shared processor. A maxi- 

mum of seven bytes is allowed for a shared 
processor. If R6 is zero and the command 
processor is special shared, (biased at 
X'1C400 I ), the program is reentered at the 
point of interruption. 

R13, R14 Contain the account (in TEXT format) in 
which the load module resides. :SYS is 
specified for shared processors. 

RIO, Rl 1 Contain the password in TEXT format. If 
there is no password, zero should be used. 



RO, Rl Contain either FDP or DELTA in TEXTC 

format or a zero. If one of the two debug- 
gers is specified, the interpretive exit is to 
be taken with the debugger associated. 

The system job step processor, STEP, interprets such an 
exit as a call on the specified program. It also loads 
the TEXTC name of the command processor that issued 
the interpretive exit into R4and R5. Before a com- 
mand processor issues an interpretive exit, it must have 
closed all its DCBs and, in general, have cleaned up. 

The job step processor arbitrarily removes the command 
processor from the user's virtual map. This means that 
all data and DCBs are gone. 



2. BREAK and CONTROL Y Control - If the terminal user 
depresses the BREAK key during operation of a pro- 
cessor or user program and that program did not request 
BREAK control, the program is aborted and the com- 
mand processor is loaded and entered with bit 30 of 
J rTELFLGS in the J IT set. If the interrupted program 
has requested BREAK control, the program's BREAK rou- 
tine is entered. 



If the terminal user depresses CONTROL Y during the 
execution of a processor or user program and the com- 
mand processor is not special shared, the program is 
aborted and the command processor is loaded and en- 
tered. If the command processor is special shared and 
has no data and no DCBs, the user program is left as is 
and the command processor is entered. This gives the 
command processor the opportunity to continue the 
interrupted program. 



If the terminal user depresses CONTROL Y while a 
command processor is in control, the event is ignored 
and the current operation is continued where it was 
interrupted. 



If the terminal user depresses BREAK while a command 
processor is in control and BREAK control has not been 
requested or BREAK control has been reset via the 
M:INT CAL, the BREAK event is ignored and the com- 
mand processor is continued where it was interrupted. 
If a command processor has requested BREAK control, 
it is interrupted at its BREAK control address. 



The format of the BREAK control CAL is: 

CAL1,8 FPT 
where FPT points to word of the FPT shown below. 

WordO 



X'OE' 



1 2 3M 5 6 7 







•0 



BREAK routine address 



8 9 10 111 12 13 14 15 1 16 17 18 1^1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



102 Command Processor Programming 



If the CP bit is set, the BREAK control routine of the 
interrupted program is reestablished. This allows a user to 
depress CONTROL Y while in a program with BREAK con- 
trol, enter his special shared command processor which 
remembers the old BREAK control address, and then estab- 
lish BREAK control for the command processor. If the user 
wishes to continue, the command processor may set the 
CP bit and execute the BREAK control CAL before exiting 
back to the user's program. The BREAK routine address in 
this case should be the one that was active when the com- 
mand processor was first entered as a result of CONTROL Y. 

3. Exit, Error, Abort CAL, and I/O Abort Control — If any 
exit or abort condition occurs during execution of a 
program, the program is aborted and the command pro- 
cessor is loaded and entered. Error conditions are de- 
scribed in four fields of the JIT as follows: 

• J:ABC is the address of the word in the JIT that 
contains the abort code in byte 0(see Appendix B 
of the CP-V/TS Reference Manual, 90 09 07). 

• ERO is the word offset into the JIT of the word 
that contains the abort subcode in byte 3. 

• J:RNST is the address of the word in the JIT that 
contains the current run status. Status settings are: 

All 

zeros means the job is executing normally. 

Bit 1 if set, the job is to be errored because of 
an M:ERR call to the monitor. 

Bit 2 if set, the job is to be aborted because of 
an M:XXX call to the monitor. 

Bit 3 if set, the job is to be errored because of 
an E key- in by the operator. 

Bit 4 if set, the job is to be aborted because of 
an X key-in or a line disconnect. 

Bit 5 is reserved for future use. 

Bit 6 if set, the job is to be aborted because a 
limit has been exceeded (e.g., maximum 
pages out). 

Bit 7 if set, the job is to be aborted because of 
an error (most likely I/O) as specified in 
J:ABCand ERO. 

Bit 8 if set, the job is to be aborted because of 
an illegal trap. 

• J:ASSIGN contains the address of the word in the 
JIT, the rightmostnine bits of which indicate which 
limit was exceeded. This field is set in conjunction 
with bit 6 in the RNST field of the JIT. The bits, 
if set, mean: 

Bit 23 the maximum disk allocation limit 
exceeded. 

Bit 24 the maximum time limit exceeded. 



Bit 25 the maximum scratch tape limit 
exceeded. 

Bit 26 the maximum temporary disk space 
limit exceeded. 

Bit 27 the maximum permanent disk space 
limit exceeded. 

Bit 28 the maximum diagnostic pages output 

limit exceeded. 

Bit 29 the maximum user pages output limit 

exceeded. 

Bit 30 the maximum processor pages output 

limit exceeded. 

Bit 31 the maximum punch output limit 

exceeded. 

4. CAL Control of JIT Error Condition — This CAL al lows 
control of JIT error conditions without special JIT ac- 
cess. The form of the CAL is: 

CALM fpt 
where fpt points to the word shown below. 



X'06' 



12 3 14 5 6 7 



9 10 11112 13 14 15116 17 18 19T20 21 22 23124 25 26 27128 29 30 31 



The monitor (the ALTCP portion) verifies that the pro- 
gram issuing the request is a command processor through 
use of UH:FLG. It then sets J:ABC, ERO, byte of 
J:RNST, and bit 30 of J:TELFLGS to zero. (Bit 30 of 
J:TELFLGS indicates whether or not the BREAK key has 
been depressed.) If the program issuing the CAL is not 
a command processor, control is returned to the user 
program with CC1 set. 

5. Registers — Upon entry to a shared processor from a 
command processor, the registers must contain the 
following: 

R0 the TCB, address of the user program. 

R4, R5 the name of the calling command processor 

in TEXTC format. 

R6, R7, the name of the called processor in TEXTC 
R8 format. 

R10,R11 the password in TEXT format (zero if none). 

R13, R14 the account of the called processor in TEXT 
format. 

6. CAL Control of Terminal Modes — Control of terminal 
modes is provided by a variation of the Change Ter- 
minal Type CAL (see the CP-V/TS Reference Man- 
ual, 90 09 07). 
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PUBLIC LIBRARIES 

The system may have several shared public libraries. Each 
library is a unit tailored to the requirements of the installa- 
tion. The user associates a public library with his program 
by specifying the library name (Pi where 1=0-9, JO, or Jl) 
in a LINK or RUN command. The rule governing library 
units are as follows: 

1. Link loads the user data immediately above the area 
reserved for the library data. Load reserves an entire 
page for library data. 

2. No initialization is provided for this temporary library 
data either by the loader or by the system. There must 
be an initialization program if initialization is required. 

3. Each library unit must separate data (CSECTO) and pro- 
gram (CSECT1) information into separate assemblies so 
that separate ROMs will be produced for each. 

4. All code must be under CSECTs with protection type 
for variable data or 1 for procedure and constant data. 
No DSECT section may be used. 

5. The library must be self-contained (i.e., there can be 
no unsatisfied references). This must be true for the 
data portion itself and the total library. For example, 
a FORTRAN I/O library must search the DCB chain 
rather than make a direct reference to the DCB itself. 



Public library :P1 contains single and double precision trig- 
onometric functions, exponential and logarithmic functions, 
standard set-up routines, initialization and termination rou- 
tines, and input/output conversion and transmission routines. 
Fewer than 1000 words of storage are required for temporary 
storage by each user of the library. Over 5100 words of li- 
brary code are shared among all concurrent users. 

FDP users require public library :P0 which consists of nearly 
1400 words of temporary storage per user; over 10,000 words 
of code are shared among the concurrent users. 

Real-time users require public library :P4 which consists of 
fewer than 1000 words of temporary storage per user; over 
5300 words of code are shared among the concurrent users. 

The remaining routines (approximately 190) of the complete 
FORTRAN library are organized in two ways: 

1 . They are organized in the :BLIB file as card-image ROM 
decks that are used by the Link loader to satisfy library 
references. 

2. They are organized in the :LIB/:DIC files as 22 library 
load modules. 

This organization permits rapid loading by the overlay loader 
or Load. The overlay loader uses the file :DIC, which con- 
sists of a record keyed by each DEF in :LIB and the group 
number as its value to find the LM names necessary to satisfy 
references. 



CP-V PUBLIC LIBRARIES 

Six public libraries are available to the system programmer. 
One library (:P1) includes the most commonly required rou- 
tines from the Extended FORTRAN IV library (about 65 rou- 
tines). Another (:P0) includes :P1 plus the FORTRAN Debug 
Package (FDP). A third (:P4) includes :P1 plus the FORTRAN 
real-time features. The fourth library (:J0) contains the JIT 
definition. Most executing users need only the first library; 
users who are debugging need the second; real-time users 
need the third. The fifth library (:J1) contains the monitor 
(M:MON) definitions and is useful only to programs which 
interface directly with monitor tables and routines. The 
sixth library (:J2) is actually a subset of :J1. It contains 
the definitions for the LITERALS module of the monitor and 
is useful primarily to programs that wish to access the moni- 
tor's extensive literal and constant pool in order to avoid 
duplicating these items. (All programs have read access 
to the LITERALS module.) 

The entire Extended FORTRAN IV I ibrary consists of 252 rou- 
tines (ROMs) totaling more then ten thousand instructions 
and over 800 data words. 

The package includes more than 350 DEFs. These routines 
are described in Extended FORTRAN IV Library Technical 
Manual, 90 15 24, and Sigma 5/7 Mathematical Routines 
Technical Manual, 90 09 06. 



Real-time versions of :BLIB, :LIB, and :DIC must be main- 
tained in the real-time system account (e.g., :SYSRT). 

One essential monitor subroutine must be added to the stan- 
dard released library, SrOVRL. It is normally added during 
the System Generation process but must be remembered when- 
ever a new library is being installed. 



The size and description of routines 
Table 40. 



:LIB are given in 



CREATING PUBLIC LIBRARIES 

Users may add their own public libraries to meet specific 
requirements. The necessary procedures are given below. 

The procedure for creating public libraries consists of several 
steps. The desired data and program elements are loaded, 
and the dictionary for the library (DEFs) is filed for loader 
use. Next, the procedure is filed so that SYSMAK can place 
it on swap storage during system initialization. In the 
process, the program SYMCON is used to retain only those 
DEFs required in the final linking process, thus saving loader 
stack search time. Figure 13 illustrates the process of creat- 
ing a public library. 
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Table 40. 


Routines in :LIB Library File 


Group 


Size 


Description 


1 


96 


Complex double precision mathe- 
matical routine drivers. 


2 


72 


Complex mathematical routine 
drivers. 


3 


92 


Double precision mathematical 
routine drivers. 


4 


86 


Single precision mathematical 
routine drivers. 


5 


277 


External revisions of compiler 
intrinsic functions. 


6 


618 


Complex double precision mathe- 
matical routines. 


7 


538 


Complex single precision mathe- 
matical routines. 


8 


74 


Double precision mathematical 
routines. 


9 


104 


Miscellaneous integer functions. 



Table 40. Routines in :LIB Library File (cont.) 



Group 


Size 


Description 


10 


76 


Miscellaneous real functions. 


11 


78 


Logical functions. 


12 


18 


Conversion routines. 


13 


362 


DSINH, DTANH, DASIN, 
DTAN. 


14 


308 


Miscellaneous nonnumeric functions. 


15 


20 


Overflow and divide check. 


16 


508 


Nonstandard and asynchronous I/O. 


17 


750 


Input and INPUTL. 


18 


160 


Random access. 


19 


514 


Disk buffer. 


20 


102 


Keyed file I/O. 


21 


836 


Name list I/O. 


22 


938 


Defined file I/O. 

























Data ROMs for 
Public Library 






|f LOAD 






Data LM 
(:Pnnn) 


equal to size of data in source LM 




f DEFCC 


>M 








DEFs for Data 
(:PnDATA) 




Procedure ROMs 
for Public Library 






















f LOAD (or 


LYNX) 




Public Library 
LM(:Pnn) 


















DEFCOM 


- 


f SYMCO 


N 


- 


f SYSMAK 


^ 




Public Library DEFs 
for (:Pn) used by 
Link and Load. 




Public Library LM 
(:Pnn) with only 
necessary DEFs. 




Absolute Copy of 
procedure on swap 
storage. 






No 


te: n = 0-9 for publi 


z librarie 


ss 0-9. 











Figure 13. Public Library Creation Process 
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LOADING PUBLIC LIBRARIES 

Default loading for Link includes the basic FORTRAN public 
library (:P1) and a search of the system (ROM) library if 
there are unsatisfied references. This is the same as if the 
user had specified (:P1) in a RUN or LINK command. If the 
user has not explicitly asked for :P1 and no reference to 
9INITIAL is found, the procedure for :PI is not associated 
with the user program execution although the 900 data words 
remain committed because of the single pass loader oper- 
ation. Figure 14 is a generalized flow of the LINK process 
relative to libraries. 

Since the overlay loader operates in two passes, it makes 
an explicit association of :P0 and :P1 to a program in 
absence of other instructions. This process is illustrated in 
Figure 15. 

Real-time users must specify public library :P4 and the real- 
time version of the system library. This means that the Link 
processor requires specification of P4 and inclusion of file 
:BLIB in the real-time system account (e.g., :SYSRT) as a 
library file identification. It also means that the overlay 
loader requires specification of :P4and the real-time system 
account in the library account list. 



SHARED PROCESSOR MAINTENANCE (P^P) 

Development and check out of CP-V systems is simplified 
through use of DRSP (Dynamic Replacement of Shared Pro- 
cessors). DRSP allows replacement, creation, or deletion 
of shared processors while the system is operational. The 
extra processor space in the shared processor tables must be 
allocated during system generation (PASS2). Processors 
that are normally invoked following a recovery cycle 
(ALLOCAT, GHOST 1, RECOVERY, and XDELTA) are not 
dynamically replaceable. DRSP must be run as a shared 
processor in order to maintain integrity of the monitor's 
processor tables. 



Note: XDELTA (Executive Delta) is an additional debug- 
ging aid that is optionally retained at system ini- 
tialization. XDELTA is described in the Delta 
chapter of theCP-VAS Reference Manual, 900907. 



DRSP can be run either as an on-line or a batch processor. 
Input can be either from the command device or from a 
terminal. DRSP is called on-line by entering the name of 
the processor as a TEL command. 



Example: 

JDRSP© 
DRSP HERE 



TheDCBs used by DRSP which maybe assigned by the user are: 

1. M:SI for command language input. 

2. M:LL for terminal output. 

3. M:SL for listing of input commands during a batch run 
and diagnostic message output. 

DRSP COMMANDS 

The seven DRSP commands are 

ENTER 

REPLACE 

DELETE 

LIST 

LIS TALL 

? 

END 

In the DRSP command descriptions, the term 'proname' refers 
to the name of a processor as found in the shared processor 
tables. The file specified by proname must be in load module 
format. 

All of the above commands except " ?" can be followed 
by comments, which will be printed as part of the com- 
mand line during a batch run of DRSP. To add comments, 
terminate the command with a blank character followed 
by a period. All characters entered after the period are 
treated as comments. The comments are terminated by © 
or end-of-card. Comments cannot be continued to the 
next record. 

ENTER The ENTER command is used to enter a new 

shared processor into the system. 

The format of the command is 

E[NTER] proname [{^ I j^} fid ]['°P tion ] D°P tIon ] [/°P tion ] 

where the options are as follows: 

P][S] [D] [P] [M] [X][t] [B] [G] [C] specifies one or more 
flags to be associated with the processor. The 
flags indicate the following. 

J processor is allowed to alter the JIT. 

S special shared processor. 

D processor is a debugger. 

P public library. 
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Read and Load 
Specified ROMs. 



Error Message: 
Compiler for debug 
and library not 
associated. 



Flag DCB REFs 
to be built later. 




c 



Done 



yes 



no 



( Done J 



Open and 
search :BLIB 



Search for library 
files and load 
those found. 




Done 



3 



Figure 14. Generalized Library Load Process (Link) 
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C Done J 



PUBLIC 
LIB 



Process ROMs or LMs 
from named files and/or 
from BI or GO. 




REFs 
to9DBINIT 
no\or 9INITIAL 

9 



Determine which :Pn 
(either :P0 or PI). 



PUBLIC 
LIB 



Initialize UNSAT list. 




Get next UNSAT entry. 




no more 
entries 



Satisfy remaining REFs 
from :LIB in this account. 




.or 9INITIAL / no 
o 



f Done J 



Determine which :Pn 
(either :P0 or :PT). 



PUBLIC 
LIB 



( Done J 




Get the requested 
:Pn (from :SYS) and 
associate it with the 
load module being 
built. 



f Return J 



Note: If NOSYSLIBis presenton the .'LOAD card, the UNSAT list is empty or consists of those sources (accounts and/or :Pn) 
mentioned under the UNSAToption. If NOSYSLIBis not present, the UNSATIist consists of the above plus the :SYS 
account (which occurs last). For LYNX, the NL option has an identical effect upon the library account list. 



Figure 15. Generalized Library Load Process (Overlay Loader) 
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M processor allowed maximum memory during 
execution. 

X piocessorallowedtoexecutetheMrSYS CAL. 

T command processor accessible by terminal 

users. 

B command processor accessible by batch 

users. 

G command processor accessible by ghost users. 

C command processor accessible by terminal, 
batch, and ghost users. 

If Dor Pis specified, Sis redundant and is assumed. 
If the C flag is used, the specific flags (T, B, G) 
are redundant and should not be used. Various 
combinations of the above are possible up to a 
maximum of six characters; e.g., a processor that 
is allowed to alter the JIT and has maximum mem- 
ory available for execution would be flagged JM. 
The flag combination PD or usage of the P flag 
when the processor name is other than :Pnn results 
in an error message. 

PERM specifies that the processor is to be available 
to users even after a system crash. The processor 
will be present both in the system account (:SYS) 
and on swap disk. "Empty" slots must be avail- 
able in the disk copy of the processor tables. If 
this option is not used, the new processor version 
will reside only on swap disk and will be lost in 
the event of a crash. The version of the processor 
that will be restored is the version in the system 
account at the time of the crash. 

W specifies that if the proname cannot be entered 
into the processor table because there are no name 
slots free, DRSP is to wait until there is a slot 
available. If this wait option is not specified, 
the command terminates without entering the 
new processor. 



REPLACE The REPLACE command is used to replace an 
existing shared processor. If this command is used, the 
previous version of the processor is lost. However, cur- 
rent users continue to use the old copy until they are 
disassociated from the processor. 

The format of the command is 



PERM specifies that the new version of the pro- 
cessor is to be available to users even after a sys- 
tem crash. This version of the processor will be 
present both in the system account (:SYS) and on 
swap disk. "Empty" slots must be available in 
the disk copy of the processor tables. If this 
option is not used, the new processor version will 
reside only on swap disk and will be overwritten 
in event of a crash by the processor version in the 
system account. 

W specifies that if the proname cannot be entered 
into the processor table because there are no name 
slots free, DRSP is to wait until there is a slot 
available. If this wait option is not specified, 
the command terminates without replacing the old 
processor. 



DELETE The DELETE command prevents further user 
association with a processor. Users associated with the pro- 
cessor when this command is issued will continue to use the 
processor until they disassociate. 

The format of the command is 

D[ELETE] proname [, PERM] 

where PERM specifies that no new users will ever be asso- 
ciated with this processor (even after a system crash). 

LIST The LIST command lists the processor name, the 
name associated with each entry in the processor name table, 
and the amount of disk space occupied by the processor. 

The format of the command is 



LflSTj 
where 



[pronamef] 
#xx[-yyjjj 



proname specifies an explicit processor name. (The 
proname M:DUMLM appears many times in the pro- 
cessor tables. If selected, all these entries will 
be listed. ) 

xx-[yy] specifies the name table index or a range 

of name table indexes to be listed. 

Initial use of the LIST command with no proname or index 
specified will provide a list of each processor table entry 
and its corresponding table index. 



R[EPLACE] proname | W t TH fM' c ' [pption][,option] [option] 

where the options are as follows: 

P][S][D][P][M][X][T][B][G][C] specifies flags to be 
associated with the processor. The option is the 
same as for the ENTER command. 



LIST ALL The LISTALL command lists each shared pro- 

cessor name and its entries in the following tables: 

PB:HPP Head of the physical page chain. 

PB:TPP Tail of the physical page chain. 

PB:DSZ Number of data pages. 
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PBrDCBSZ Number of DCB pages. 

PH:PDA Disk address of first procedure page. 

PH:DDA Disk address of first page of data and DCBs. 

PB:UC Number of users in core using the processor. 

PB:LNK Processor number of next overlay. 

PB:PVA Virtual page number of first procedure page. 

PB:HVA Virtual page number of first unused page. 

P:SA Processor flags and start address. 
The format of the command is 

LISTAL L rfr™ me j| 
[*xxl-yyjj 

where proname and xx[-yy) are as defined in the LIST 
command. 

? The question mark command requests a detailed error 

message when an error has been noted by DRSP. The com- 
mand is applicable only for the on-line mode. Its function 
is described in detail in the section "DRSP Error Messages". 
The format of the command is 



END The END command terminates DRSP. The format 

of the command is 

END 

DRSP LIMITATIONS AND RESTRICTIONS 

The following lists DRSP limitations and restrictions: 

1. Only users with a privilege level of CO or greater are 
allowed to use the ENTER, REPLACE and DELETE com- 
mands. The LIST command requires a privilege level 
of 80 or greater. 

2. There must be sufficient space in the swap disk 
processor/overlay area to hold the new or replacing 
entry. This extra space is allocated by SYSGEN 
PASS2 via a :SPROCS control card. 

3. Replaced or entered items must be accessible load 
modules. 

4. Onlyone level of overlay is permitted in a processor. 

5. A processor overlay must be PROCEDURE only. 

6. ALLOCAT, GHOST 1, RECOVER, XDELTA, M:DUMLM 
may not be processed with DRSP commands. 



7. Overlays for processors cannot be replaced or entered 
individually. 

8. GETs of programs saved with an associated processor 
most likely will not work if the processor has been 
changed between SAVE and GET. 

9. When replacing the FILL processor a modified proce- 
dure is required: Following REPLACE FILL WITH 
N. A. P. , OPTION 1 thru 3, the user has to abort the 
FILL ghost. This is done via a message to the operator 
to key in X, id, where id is the SYSID of the FILL 
ghost which appears when the message 'REQUEST FILL, 
NO FILL, OR INSTANT SQUIRREL (F, N, S)' is output 
on operator's console. This will ensure that the FILL 
copy in the user swap disk area is destroyed and the 
replaced version of FILL is brought in the next time 
FILL wakes up. 



i DRSP ERROR MESSAGES 

The error message structure of DRSP is designed to give a 
user detailed information when so desired without burdening 
him with long typeouts when the error is obvious. When 
running on-line, DRSP will respond to commands in error 
by typing 

EH@n 

where n is the character position at which an error was first 
detected. If the user requires more information, he responds 
with a question mark (?). DRSP responds with a detailed 
error message (see Table 41). If the error is obvious, the 
user may retype the command (or proceed to the next com- 
mand). For errors that occur after command syntax is com- 
pleted, this message changes to 



EH 



since command character position is meaningless. 

In batch mode, the detailed error messages are printed with- 
out the interrogative sequence described above. 

In addition to error messages, certain other messages are 
given for information purposes only (see Table 42). No re- 
sponse is expected. 

Except where noted, the error condition truncates execution 
of the requested command. 



i DjRSP COMMAND SUMMARY 

Table 43 contains a summary of commands for the DRSP 
processor. The left-hand column specifies the format and 
the right-hand column defines the function. 
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Table 41 . DRSP Error Messages 



Message 


Mean ing 


BREAK 50 
BREAK 51 
BREAK 52 
BREAK 53 


User hit BREAK during DRSP execution. The number defines the point at which 
the DRSP processor exited, as described in the UTS Reliability and Maintain- 
ability Technical Manual, 90 19 90. 


CANNOT OPEN THE FID 


DRSP cannot access the load module defined by the fid. 


CAN'T OPEN M:BO (PERM) 


I/O error detected while trying to open the output file in :SYS. The processor 
is entered/replaced on non-"PERM" basis. 


DON'T USE COMMAND ON 
TEL/CCI 


ENTER or DELETE commands must not specify the proname 'TEL' or 'CO'. 


DRSP I/O ERROR IN READING 
COMMAND 


Error detected in reading DRSP command. 


DRSP I/O ERR/ABN (CLOSE) 


Error or abnormal condition detected at CLOSE of output file. The processor 
is entered/replaced on non-"PERM" basis. 


DRSP M-.BO ERROR (PERM) 


I/O error detected while writing or closing the output file in :SYS. The 
processor is entered/replaced on non-"PERM" basis. 


DRSP M:EI ERROR (PERM) 


I/O error detected while reading file fid. The processor is entered/replaced 
on non-"PERM" basis. 


DRSP M:EI ERROR (WRITES WAP) 


I/O error detected while reading fid for writing on the swap disk. 


DRSP NOT FOUND IN 
PROCESSOR TABLES 


DRSP must be run as a shared processor in order to maintain integrity over the 
monitor's processor tables. 


DRSP PROGRAM ERROR 
(SHOULDN'T HAPPEN) 


DRSP detected contradictory conditions during processing. Requires system 
programmer intervention. 


ERR MSG NOT FOUND. 
KEY = xxxxxx 


No error message corresponds to the error code xxxxxx generated. Please 
report this system error. 


FID IS NOT A LOAD MODULE 


Error or abnormal return executed while trying to read the TREE record of the 
load module specified by fid. 


FILE STORAGE LIMIT IN 
SYSTEM ACCOUNT 


When writing the load module into the :SYS account for the PERM option, the 
file space for that account is exceeded. 


ILLEGAL COMMAND 


Command entered is not defined in DRSP. 


ILLEGAL COMMAND OPTION 


An optional parameter typed in the command is not recognized. 


ILLEGAL INDEX RANGE 


Index specified in LIST/LISTALL command not within legal range of processor 
name table. 


ILLEGAL LMN (LOAD 
BIAS CHECK) 


Illegal load bias detected when processor written to swap disk. 


ILLEGAL PRONAME, NOT 
:PNN FORMAT 


A processor flagged as a public library must conform to the name format :Pnn. 


ILLEGAL PROTECTION TYPE 
FOR PUBLIC LIBRARY 


The load module for a public library must be root only and procedure only. 
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Table 41. DRSP Error Messages (cont. ) 



Message 


Meaning 


INCORRECT FID 


The fid specified exceeds the field maximum for name (15 characters) or 
account (8 characters) or password (8 characters). 


INSUFFICIENT MEMORY TO 
READ MAX RECORD OF FID 


DRSP has failed to acquire enough memory to read the largest record of the 
load module specified as fid. 


INSUFFICIENT MEMORY 
TO READ TREE 


Memory space available to user is not sufficient to process the load module 
specified in the ENTER or REPLACE commands. 


INSUFFICIENT PRIVILEGE 
FOR DRSP USAGE 


The user must have a privilege level of 80 or greater to execute any DRSP 
commands. 


INSUFFICIENT PRIVILEGE 
LEVEL TO PROCESS THIS 
COMMAND 


The user does not have sufficient privilege of CO to process ENTER, REPLACE, 
and DELETE commands. 


INSUFFICIENT SPACE ON 
SWAP RAD 


The disk space allotted for new or replaced load modules is too small for the 
load module specified. 


INSUFFICIENT VIRTUAL 
MEMORY TO EXECUTE DRSP 


There are not enough virtual pages to allow DRSP to access the monitor. 


NO ERRORS 


No errors were encountered during command execution. 


NO PRO NAME SLOTS AVAILABLE 


The number of extra processor name table entries is exhausted. 


NO SUCH PROCESSOR 


The proname entered cannot be found in the processor tables. 


ONLY ONE LEVEL OF OVERLAYS 
FOR SHARED PROCESSORS 


When analyzing the load module TREE record, more than one level of processor 
overlay was indicated. 


ONLY PROCEDURE IS ALLOWED 
IN A PROCESSOR OVERLAY 


DRSP checks a load module specified as an overlay for procedure only. 


OVLY LINK EXCEEDS TABLE 
LIMIT 


A system error to be reported. 


PROCESSOR OVERLAY SLOTS 
EXHAUSTED 


There are not enough empty processor overlay locations in the name table to 
fill the load module requirement. This check on the name table occurs during 
the write to the swap disk. 


PROCESSOR/OVERLAY 
ALREADY EXISTS 


User tried to ENTER a processor or overlay name that exists in the table. 


PRO NAME IS ILLEGAL 


Some routine cannot be entered or replaced with DRSP (e.g., XDELTA, 
RECOVER, GHOST1, ALLOCAT, M:DUMLM). 


PRO NAME REQUIRED 


A program must be specified with the ENTER, REPLACE, and DELETE commands. 


RAD OVERFLOW 


Disk space allotted for the shared processors is exhausted. 


READ ERROR READING 
FID (COPY) 


I/O error detected while trying to read the processor for the copy into the 
system account. 


SWAP I/O ERROR (QUEUE) 


I/O error detected while writing processor to the swap disk. 


WRITE ERROR WRITING 
FID (COPY) 


I/O error detected while trying to write the processor into the system account. 
The processor is entered/replaced on non-"PERM" basis. 


WRITE RAD FILE I/O ERRORS 


I/O error detected while writing the processor to the swap disk. 
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Table 42. DRSP Information Messages 



Message 


Meaning 


DRSP HERE 


Routine title typed when user first enters DRSP. 


DRSP INHIBIT SET 


Another user is manipulating the shared processor tables and prevents any 
other user executing the ENTER, REPLACE, and DELETE commands. However, 
the LIST and LISTALL commands can be executed at any time. 


fid NEEDS xxxx GRANULES 


If DRSP cannot find sufficient disk space in any available slot, it feeds 
back to the user the number of granules required to enter/replace the 
new load module. 


proname REPLACED IN RAD 
SLOT #x 


While exercising the "PERM" option, the proname in slot *x has been 
replaced by the proname specified in the current command. 


PRONAME FOUND ON RAD 


The proname already exists in the disk version of the processor tables when 
DRSP tries to execute the ENTER, PERM option. The "PERM" function is 
completed for the new copy. 


PRONAME NOT FOUND ON RAD 


The proname cannot be found in the disk version of the processor tables when 
DRSP tries to execute the REPLACE,PERM option. The "PERM" function is 
completed for the new copy. 


USERS ASSOCIATED 


DRSP attempts to replace TEL or CCI but finds there are users associated. The 
message is repeated periodically as long as users remain associated. 



Table 43. DRSP Command Summary 



Command 


Description 


D[ELETE] proname ,[PERM] 


Prevents further user association with a processor. 


END 


Exits normally from DRSP. 


E[NTER] proname 
[,option][,op 


"fFROMU,"] 
IWITH } f,d j 

Honj[, option] 


Enters a new shared processor into the system. 


L MCE3} 


Lists the processor name, the name table index, and the amount of disk 
space occupied by the processor. 


lbtall {EE3} 


Lists each shared processor name and its entries in certain tables. 


R[EPLACE]proname[}™°^} fid] 
[, option][, option][, option] 


Replaces an existing shared processor with a new shared processor. 


? 


Requestsa detailed error message when an error has been noted by DRSP. 
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8. ONLINE PERIPHERAL DIAGNOSTIC FACILITIES 



INTRODUCTION 

This chapter describes the system facilities that are designed 
for use by Xerox in the development of peripheral hardware 
diagnostic programs. The system procedures and the Diag- 
nostic DCB d escribed in this chapter should jever be used 
in any user-written programs. Their description is included 
in this manual only for completeness of documentation. Any 
program that uses them may seriously affect the operation 
and integrity of the system. 

The facilities described in this chapter are used in the fol- 
lowing types of Xerox processors: 

• Functional tests for peripheral devices that isolate hard- 
ware problems to the lowest possible level. 

• Exercisers that verify that the peripherals are operat- 
ing correctly. 

• Preventive maintenance tests that reduce the amount of 
time that peripherals are down for repair. 

These tests and exercisers may be run at an on-line terminal 
while the CP-V system is in normal operation. 

The facilities described in this chapter include one assem- 
bler directive, the special Diagnostic DCB (DDCB), and 
eight system procedures. The assembler directive allows the 
user to specify that a control section is to begin at a page 
boundary. The Diagnostic DCB is a data area that allows 
the user to issue his own I/O commands. 

These eight procedures reside in SYSTEM DIAG along with 
two other system procedures — M:DPART and D.-DRET. 
(M:D PART and MrDRETare described in the SYSCON chap- 
ter in the CP-V/SM Reference Manual, 90 16 74, because 
they are used by SYSCON.) The eight system procedures 
perform the following functions: 

Procedure Function 

M:DDCB Generates a diagnostic data control 

block. 

M:DOPEN Opens the device associated with the 
Diagnostic DCB for diagnostic purposes. 

M:DCLOSE Terminates and inhibits all I/O associated 
with the Diagnostic DCB. 

M:BLIST Converts the user's virtual command list 

into a physical command list and stores 
the result in the Diagnostic DCB, or 
requests that a TIO, TDV, or HIO be 
performed on the device to which the 
Diagnostic DCB is opened. 

M:SIO Initiates the user's I/O. The commands 

for the I/O are stored in the Diagnostic 
DCB. 



Procedure Function 

M:LOCK Either locks the user in core or resumes 

normal swapping for the user. 

M:MAP Converts a specified virtual address to a 

physical address or a specified physical 
address to a virtual address. 

M:DMOD# Obtains the controller model number, 
the device model number, and the type 
mnemonic associated with a given de- 
vice address, and availability informa- 
tion (i.e., device busy, device parti- 
tioned, controller partitioned, and DIAG 
key-in has been performed). 

RESTRICTIONS 

For both security and system performance reasons, there are 
certain restrictions on the use of the facilities described in 
this chapter. These restrictions are: 

1 . The system manager must give approval before the sys- 
tem will process some of theCALs. (Note that MrDDCB 
does not generate a CAL.) This approval is transmitted 
to the monitor via the operator key-in. 

I DIAG id 

where id is the diagnostic user's id and identifies the 
user as the current diagnostic user. This is reset by the 
monitor between fob steps. 

2. The M:MAP procedure requires a privilege of A0 or 
higher. The user is aborted if his privilege level is 
insufficient. 

3. The M:LOCK procedure requires a privilege level of 
A0 or higher and the user must have been specified as 
the current diagnostic user via the DIAG key-in or 
have a privilege level of CO or higher. If one of these 
conditions is not met, the user is aborted. 

4. The M:DOPEN, M:DCLOSE, M:BLIST and M:SIO pro- 
cedures require a privilege level of A0 or higher and 
the user must have been specified as the current diag- 
nostic user via the DIAG key-in. If the conditions are 
not met, the user aborted. 

5. User registers SRI and SR3 are volatile for the 
M:DOPEN, M:DCLOSE, M.-BLIST, M:SIO, M:LOCK 
and M:MAP procedures. 

PSECT DIRECTIVE 

The PSECT directive specifies that the control section which 
follows is to begin on a page boundary. This directive allows 
diagnosticians to ensure that such things as the Diagnostic 
DCB and buffers do not cross page boundaries. The PSECT 
directive is described in detail in the Meta-Symbol/LN, 
OPS Reference Manual, 90 09 52. 
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SYSTEM PROCEDURES 

Monitor procedures enable the user's symbolic Me ta-Symbo I 
program to request a variety of monitor functions. The on- 
line diagnostic procedures described in this chapter have 
the same general format as those described in the CP-V/BP 
Reference Manual, 90 17 64. 

When using Meta-Symbol, the monitor diagnostic procedure 
library is invoked via the directive 

SYSTEM DIAG 

This directive defines all of the monitor procedures. The 
Sigma 6 and 7 computer instruction set is invoked by the 
directive 

SYSTEM SIG7[F] [D] [P] 

where F specifies the floating-point option, D specifies the 
decimal option, and P specifies privilege instructions. 

The Xerox 560 and Sigma 9 computer instruction sets are 
invoked by the directive 

SYSTEM SIG9[P] 

where P specifies the privileged instruction set. 

Thus, both the SYSTEM DIAG and the SYSTEM SIG7 or 
SYSTEM SIG9 directives should be used. The SYSTEM BPM 
directive should also be used if any of the procedures de- 
scribed in the CP-V/BP Reference Manual, 90 17 64, are 
used in the program. 



CREATE DIAGNOSTIC DATA CONTROL BLOCK 

M.'DDCB The diagnostic data control block procedure 

generates a data area in the user's program that is accessible 
by the user. This data area must be given a label, the first 
two characters of which are F: (e.g., FrDIAG). 

The Diagnostic DCB (hereafter referred to as the DDCB) must 
be used when the diagnostician is going to perform his own 
I/O through use of the diagnostic procedures described in 
this chapter. In addition to containing standard types of DCB 
information, theDDCBcontains the user's I/O command list. 
The DDCB format is described in detail at the end of the 
chapter. Because the DDCB has its own format, the only CALs 
that may be issued to the DDCB are the diagnostic CALs. 

The MrDDCB procedure call is of the form 

label MrDDCB (DEVICE, name), (CLIST,n)[, (option)]. . . 

where 

label is a label that begins with the two characters F : 

and must previously have been declared a dummy 
section via a directive of the form 



DEVICE, name specifies the device that is to be 
associated with the DDCB. Name may be speci- 
fied in one of the following forms: 

1. A device type in quotes (e.g., 'CR 1 , 'LP'). 

2. An operational label in quotes (e.g., 'LO 1 , 
■EO'). 

3. The physical address of the device expressed 
in hexadecimal (e.g., X'0080', X'0202'). 

CLIST, n specifies that n words are to be reserved 

for the user's command list. The maximum value 
that can be specified for n is 24. 

The options are: 



SN 



rr . ii 

r \'serial number'] I 
following: 



specifies one of the 



label 



DSECT 1 



1. The number of words (n) to be reserved for 
serial numbers. The serial numbers will be 
inserted into the DDCB when the DDCB is 
opened (M:DOPEN). The maximum value that 
can be specified for n is 12. 

2. The serial number of the volume to be used for 
input or output. There may be from one to 
twelve serial numbers of from one to four 
alphanumeric characters each. 

If the SN option is not specified in M:DDCB, then 
it cannot be specified in M:DOPEN. 

ABN, address specifies the symbolic address of a 
user's routine that is to be used to analyze any ab- 
normal conditions resulting from insufficient or con- 
flicting information. This address remains in the 
DDCB until it is overridden by an ABN specifica- 
tion in a DOPEN CAL. 

The CLIST and SN options produce variable-length param- 
eters which follow the fixed-length parameters in the DDCB. 
Each variable length parameter entry is preceded by a con- 
trol word of the following form: 

Byte is the code number (X'07* for SN; X'12' for 
CLIST). 

Byte 1 is the code for entry position (X'00 1 means 

more parameter entries to follow; X'01' means last 
parameter entry). 

Byte 2 is, for the SN option, the number of signifi- 
cant data words in the parameter entry when serial 
numbers are specified. Otherwise it is zero. 

Byte 3 is the total number of words reserved for the 

entry, not including the control word (i.e., maxi- 
mum entry length). 



System Procedures 115 



Special Note : 

After generating the DDCB, Meta-Symbol resumes assembly 
in the control or dummy section that was in effect when the 
MrDDCB procedure reference line was encountered. In 
order to prevent the statements following the MrDDCB pro- 
cedure reference line from being assembled in the same sec- 
tion as the DDCB, one of the following is recommended: 

1. The control section directive preceding an MrDDCB 
reference line should be a CSECT, and the D SECT asso- 
ciated with an MrDDCB should precede the CSECT. 

2. The statement immediately following an MrDDCB pro- 
cedure reference line should be either a CSECT or a 
USECT referencing a prior CSECT. 
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M'.DOPEN The monitor Diagnostic OPEN routine opens 

the device specified in the DDCB for diagnostic purposes. 
The DDCB will not be opened if the information in the 
DDCB is inaccurate, insufficient, or contradictory. If the 
MrDOPEN is made with no options specified, the existing 
parameters in the DDCB are used. If the DDCB is already 
open when the DOPEN routine is called, an abnormal con- 
dition issignaled. If the DDCB is not open when the DOPEN 
routine is called, the DDCB is reinitialized according to 
the parameters specified in the MrDOPEN procedure call. 

Symbiont devices will only be opened if they have been 
locked, suspended, or partitioned. Nonsymbiont devices 
and devices opened with a device address specified (as 
opposed to device typeor an operational label)must be par- 
titioned and not busy or allocated to an active user. Parti- 
tioning is accomplished by using SYSCON or as a result of 
a previous DC LOSE CAL with the PART option specified. 

The MrDOPEN procedure call is of the form 

MrDOPEN [*]dcb name, (DEVICE, [*]name), . 



(STATUS, [*]address)[, (option)]. 



0*jdcb name specifies the name of the DDCB. 

DEVICE, [*Jname specifies the device that is to be 
associated with the DDCB. Name may be speci- 
fied in one of the following forms.- 

1. A device type in quotes (e.g., 'CR', 'LP'). 

2. An operational label in quotes (e.g., 'LO 1 , 
•EO'). 

3. The physical address of the device expressed 
in hexadecimal (e.g., X'0080', X'0202'). 



STATUS, [*Jaddress specifies the address of the users 
data area where the I/O status is to be stored. The 
status that is returned is in the same format as for 
the Error Log (see Appendix E). 

The options are: 

SN, 'serial number'[, 'serial number 1 ]. . . specifies 

the serial number(s) of the volume(s) that are to be 
used for input or output. The serial number may be 
from one to four alphanumeric characters. A re- 
quest for the volume(s)w?llbe sent to the operator's 
console when opening to a device type or opera- 
tional label, which the operator responds to with an 
A VR sequence (e.g., MOUNT key-in). 

NOERR specifies that records of errors from this de- 
vice are to be suppressed from the Error Log. How- 
ever, the user has the option of writing records to 
the Error Log himself, with the Write Error Log CAL. 

ABN, address specifies the symbolic address of a 
user's routine that is to be used to analyze any ab- 
normal conditions resulting from insufficient or 
conflicting information. If an X'09' abnormal 
code occurs on the open, this open abnormal ad- 
dress is set into the DDCB and return is to this 
address. If an address is not present, the user is 
aborted. 



CHAN specifies that the controller is to be reserved 
for use by this diagnostic program. A controller 
may be reserved only if it is partitioned. 

Calls generated by the MrDOPEN procedure have the formr 

CAL 1,6 fpt 

where fpt points to word of the FPT shown below. 

word 



X'05' 



0- 



DCB address 



1 2 3 14 5 6 7 18 9 10 111 12 13 14 151 16 17 18 19120 21 22 23124 25 26 27128 29 30 31 



word 1 



0- 



12 3 14 5 6 7 I 8 9 10 11112 13 14 15 1 16 17 18 19120 21 22 23 1 24 25 26 27128 29 30 31 



word 2 - device code (PT 



0- 



Device address 



1 2 3T4 5 6 TT8 9 10 111 12 13 14 15 16 17 18 19120 21 22 23 1 24 25 26 27128 29 30 31 



device code (PI) alternate form 



0- 



-0 



TEXT oplabel 



1 2 3 14 5 6 7T8 9 10 11 1 12 13 14 15 16 17 18 19120 21 22 23124 25 26 27728 29 30 31 

where TEXT oplabel is an operational label in TEXT format, 
word 3 - STATUS (P2) 



0- 



Status address 



i 2 3 ! 4 5 6 7 18 9 10 11112 13 14 15116 17 18 19I2O 21 22 23I 24 25 26 27 1 28 29 30 31 
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option ABN (P3) 



Abnormal address 



0"T 2 3 I ■« 5 6 7 Is 9 10 111 12 13 U lsl 16 17 18 19I2O 21 22 23I24 25 26 27 1 28 29 30 31 

Flags f 1 through fc in word 1 of the FPT have the signifi- 
cance indicated below (when fj = 1). 



Flag 


Significance 


f l 


NOERR was specified. Error records are to 
be suppressed from the Error Log for this 
device. 


f 2 


CHAN was specified. The controller is to 
be reserved. 


f 3 


SN was specified. Serial numbers are pres- 
ent in the FPT (in the format described 
below). 


f 4 


An operational label was specified. Word 2 
of the FPT has the alternate form. 


f 5 


Reserved for future use. 



The format for theSN variable length parameter is identical 
to that in the DDCB. The variable length parameter entry 
is preceded by a control word of the form: 

Byte — Code number (X'07 1 ) identifying the variable- 
length parameter. 

Byte 1 — Code for entry position (X'00 1 means more 
parameter entries to follow; X'OT means last 
parameter entry). 

Byte 2 — Number of significant data words in the pa- 
rameter entry (if SN). 

Byte 3 — Total number of words reserved for the entry, 
not including the control word (i.e., maximum 
entry length). 



If the user does not have at least A0 privilege, the return 
is to CAL+1 with CC1 set. 



The MrDCLOSE procedure call is of the form 
MrDCLOSE [*]dcb name 



' /PART V 
,( RETURN 



I SAME / 



where 



[*]dcb name specifies the name of the DDCB. 

PART specifies that the device associated with the 
DDCB is to be partitioned from the system resources. 

RETURN specifies that the device associated with 
the DDCB is to be returned to the system resources. 

SAME specifies that the device associated with the 
DDCB is to remain in the same status (partitioned 
or not partitioned). The default is SAME. 

The Diagnostic CLOSE routine reports the status of the de- 
vice to the operator with the following message: 

^/PARTITIONED! 
yyndd lRETURNED I 

where yyndd identifies the device. 

Calls generated by the M:DCLOSE procedure have the form 

CAL1,6 fpt 

where fpt points to word of the FPT shown below. 

word 



X'07' 



0- 



DCB address 



1 2 3 14 5 6 7 18 9 10 11112 13 14 15116 17 18 19120 21 22 23124 23 26 27128 29 30 31 

word 1 



0- 



■0 



1 2 3 14 5 6 7 18 9 10 11112 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 

where 

f . specifies the PART option when set. 

f« specifies the RETURN option when set. 

f« specifies the SAME option when set. 

If the user does not have at least A0 privilege, the return is 
to CAL+1 with CC1 set. 



CLOSE DIAGNOSTIC DATA CONTROL BLOCK 

M:DCL0SE The Diagnostic CLOSE routine terminates 

| and inhibits I/O through the DDCB. I/O cannot be per- 
formed through the DDCB until it is opened again. M:DCLOSE 
allows the user to specify whether or not the device is down 
(partitioned). 



BUILD COMMAND LIST 

1 M:BLIST The monitor BLIST routine converts the user's 

virtual command list into a physical command list and stores 
the results in the DDCB. The routine validates that no 
command crosses a page boundary and that the number of 
I/O command doublewords is less than or equal to 12. 
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The user's virtual command list must adhere to certain 
restrictions. 

• The list must use virtual rather than physical addresses. 

• No input/output command doubleword (IOCD) is 
allowed to perform I/O across a page boundary or spe- 
cify a byte count greater than one page (X'800 1 bytes). 

• The number of IOCDs must not be greater than 12. 

• I/O commands which do not cause a transfer of data 
(e.g., skip file, rewind) must have a valid byte ad- 
dress and byte count. When such commands are used 
with the ICE flag, the I/O completion interrupt occurs 
immediately. Hence, the user must handle any desired 
I/O waifactivity independently of any I/O end action. 

The user may optionally request that the I/O be started. If 
this request is made, the monitor will not return control to 
the user until either the request to start I/O has been re- 
jected, the I/O is complete, or the I/O has timed-out. The 
AIO, TDV, and TIO status and condition codes are returned 
in the user area specified by the STATUS parameter of 
MrDOPEN and in the exact format as for Error Log (see 
Appendix E). If a TIO, TDV, or HIO request is made, the 
appropriate request is executed and the status is returned in 
the user STATUS area in the format: 

word 



1 2 3 14 5 6 7 18 9 10 11 112 13 14 151 16 17 18 19120 21 22 23T24 25 26 27T28 29 30 31 



words 1 and 2 



TIO, TDV, or HIO 
status 



i~~2 Ttl 5 6 7 I 8 9 10 111 12 13 14 15ll6 17 18 I9I2O 21 22 23 1 24 25 26 27 1 28 29 30 3 



TIO specifies that a test I/O is to be performed. 

TDV specifies that a test device is to be performed. 

HIO specifies that I/O is to be halted. 

The options are: 

PRI,[*] priority specifies the priority of the I/O re- 
quest as a hexadecimal number (e.g., X'F6'). 
X'FO' is the highest priority and X'FF' is the 
lowest priority. (The higher the priority, the 
higher the placement in the queue of requests for 
the channel containing the referenced device.) 
The default is X'FF'. 

SIO specifies that the I/O is to be started. 



TIMEOUT, [*]value specifies the minimum length 
of time allowed before an I/O timeout occurs. 
The value is in decimal and represents the number 
of 4. 8 second intervals prior to I/O timeout. For 
example, a value of 2 means a minimum of 9. 6 
seconds before timeout. For spindles or disk packs, 
the maximum value used is one even if a larger 
value is specified. The maximum value accepted 
for all other devices is 63 and the minimum is 1. 
A value greater than 63 will be forced to 63 and 
a value less than 1 will be forced to one. The 
default is one. The actual time allowed before 
an I/O timeout occurs ranges from a minimum 
timeout of "value" * 4. 8 seconds to a maximum 
timeout of "value+1 " * 4. 8 seconds depending on 
when the timeout count was initiated. Therefore, 
a TIMEOUT value of 2 may cause a timeout with- 
in a range of 9. 6 to 14.4 seconds. 



word 3 



CC 



4 5 6 7 18 9 10 11112 13 14 15 



Device address 



16 17 18 19120 21 22 23124 25 26 27128 29 30 31 



where 

CC instruction's condition codes. 

Device address device address from DDCB. 

The M:BLIST procedure call has the form 



M:BLIST [*]dcb name, 



(ADR, [*]address)[, (option )]. .. 



TIO 

TDV 

I HIO. 



where 

[*jdcb name specifies the DDCB. 

ADR, [^Jaddress specifies the address of the user's 
command list. 



Calls generated by the M.-BLIST procedure have the form: 

CAL1,6 fpt 
where fpt points to word of the FPT shown below. 

word 



X'09' 



0- 



DCB address 



1 2 3 I 4 5 6 7 18 9 10 111 12 13 14 15 1 16 17 18 t9 1 20 21 22 23I 24 25 26 27 1 28 29 30 31 

word 1 



1 2 3 I 4 5 6 7 I 8 9 10 111 12 13 14 15 1 16 17 18 19120 21 22 23124 25 26 27 1 28 29 30 31 

word 2 - ADR (PI) 



* 0- 



-0 



Command list address 



1 2 3 I 4 5 6 7 I 8 9 10 111 12 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 3 



option PRI (P2) 






* 








Priority 


TT 


1 5 3 N 5 Me 


« 14 HI li i3 U 


15ll6 17 18 ?9t20 21 22 23|J4 25 26 27I28 29 3631 



118 System Procedures 



opHon TIMEOUT (Pg) 



Timeout value 



01 2 3 U 5 6 7 I 8 9 10 11 1 12 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 26 29 30 31 



where 



f« 



is set to one if SIO was specified. Otherwise, 
it is set to zero. 

is set to one when a TIO, TDV, or HIO is re- 
quested. Otherwise, it is set to zero. 

is set to one for a TIO request. 

is set to one for a TDV request. 

is set to one for an HIO request. 



If incorrect or conflicting information exists, the abnormal 
address specified in the DDCB will be used if It has been 
specified. If the user does not have at least A0 privilege, 
the return is to CAL+1 with CO set. 



START I/O 

M'.SIO The start I/O procedure call initiates the diag- 

nostic I/O specified in the diagnostic DDCB. After an SIO, 
the monitor will not return control to the user until either 
the call has been rejected, the I/O has been completed 
(successfully or with errors) or the I/O has timed-out. The 
AIO, TDV, and TIO status and condition codes are returned 
in the user area specified by the STATUS parameter of 
M:DOPEN and in the exact format as for Error Log (see 
Appendix E). 

The M:SIO procedure call is of the form 

M:SIO [*]dcb name 

where [*Jdcb name specifies the DDCB. 

Calls generated by the M:SIO procedure have the form 

CAU,6 fpt 
where fpt points to word of the FPT shown below, 
word 



X'03' 



1 2 3 14 5 6 7 



-0 



DCB address 



8 9 10 1H 12 13 14 15M6 17 18 19120 21 22 23124 25 26 27128 29 30 31 



If there is no command list in the DDCB or the validity of 
the command I ist has been destroyed by a swap, an abnor- 
mal condition results. If the user does not have at least A0 
privilege, the return is to CAL+1 with CO set. 



LOCK IN CORE 

MlLOCK The LOCK routine either locks the user in 

core or resumes normal swapping for the user. This lock in 
core reduces the user's chances of being swapped but does 
not ensure that the user will not be swapped. The user may 
ascertain whether a swap has occurred since the BLIST CAL 
by comparing J:NRS (the swap count) in the JIT with the 
SWAPCT field in the DDCB. (SWAPCT contains the swap 
count at the time of the BLIST CAL. ) The user has not been 
swapped if the two values are equal. (The external refer- 
ence J:NRS is satisfied by loading with :J0 from the :SYS 
account. ) 



The M:LOCK procedure call is of the form 



M:LOCK (no) 



where 

YES specifies that the user is to be locked in core. 

NO specifies that normal system swapping is to re- 
sume for the user. 

Once a user is locked in core, his size may not change. 
Use of the following services may result in a size modifica- 
tion. In such case, the user will be swapped. 

1. Memory management CALs. 

2. MrSEGLOAD, M:LINK, and M:LDTRC procedure calls. 

3. Associate and disassociate processor CALs. 

4. Get page CALs. 

Calls generated by the M:LOCK procedure have the form 

CAL1,6 fpt 
where fpt points to word of the FPT shown below, 
word 



X'04' 



1 2 314 5 6 7T8 9 10 11112 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 

word 1 



-0^ 



1 2 3T4 5 6 7 18 9 10 111 12 13 14 15T 16 17 18 19 20 21 22 23124 25 26 27128 29 30 31 

where f] in word 1 specifies that LOCK in core has been 
requested (fi = l)or that the LOCK is to be released (f] =0). 

If the user's privilege level is not at least A0, the return is 
to CAL+1 with CO set. 
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whc 



CONVERT address; 

M:MAP The M:MAP procedure converts a specified 

virtual address to a physical address or a specified physical 
address to a virtual address. The converted address is stored 
in general register 8. The M:MAP procedure call has the 
form 

M:MAp/p™l(ADR, [*] address) 

re 

VTP specifies virtual to physical address conversion. 

PTV specifies physical to virtual address conversion. 

ADR, [*] address specifies the location of the address, 
to be converted. 

If the user has been swapped in between issuing a BUST CAL 
and issuing a MAP CAL, the address returned from the MAP 
CAL is invalid. The user has not been swapped if J:NRS in 
the JIT is equal to SWAPCT in the DDCB. The user may 
reduce the chances of being swapped through the use of 
MrLOCK. 

Calls generated by the M:MAP procedure have the form 

CAL1,6 fpt 

where fpt points to word of the FPT shown below. 

word 



X'02' 



0- 



•0 



Addr 



6* 1 } i \ i J i 7 Is 9 ifl n i b i3 u ' is i tt i> i» )» l ri ii « alM to fe »l« » 3d"ii 

word 1 



0- 



T) — i — 2 3U 5 6 7U 9 10 111 12 13 14 15ll6 17 18 19 



0- 



20 21 22 23l24 25 26 27I28 29 30 31 



where fi indicates virtual to physical address conversion 
(fj =0) or physical to virtual address conversion (f] = 1). 

If the user's privilege level is not at least A0, the return is 
to CAL+1 with CO set. 



^ OBTAIN MODEL NUMBERS AND TYPE MNEMONICS 

M:DM0D# The MrDMOD* procedure obtains the con- 

troller model number, the device model number, the type 
mnemonic associated with a given device address, and 
specific information concerning the device (i. e. , device 
availability, device partitioned, controller partitioned, 
and DIAG key-in has been performed). 

M:DMOD # [*]device address 

where device address has the form ndd in which n specifies 
the IOP unit address (the number associated with the IOP 
letter; see Table B-2 in Appendix B) and dd specifies the 
device number (see Table B-3 in Appendix B). 



Example: 

M:DMOD# X'20F' 

The procedure verifies that such an address exists. If no such 
device address exists, CO is set to one. However, if the 
device address is valid, CO is set to zero and the following 
general registers are set: 

R8 contains the device model number in hexadecimal 
(e.g., X'0OO07122'). 

R9 contains the controller model number in hexa- 
decimal (e.g., X'00007120'). 

R10 contains the type mnemonic in EBCDIC and 
right-justified (e.g., X'0000C3D9' for CR), and 
special information flags formatted as follows: 

bit = 1 device is currently busy with an- 
other user. 

bit 1 = 1 device is partitioned. 

bit 2 = 1 device's controller is partitioned. 

bit 3 = 1 DIAG key-in has been made by 

the operator. 

bit 4=1 sub-channel 2 (alternate path) 
partitioned. 

bit 5 = 1 sub-channel 1 (primary path) 
partitioned. 

In either case, the return is to CAL+1 . 

Calls generated by the M.-DMOD* procedure have the form 

CAL1,6 fpt 
where fpt points to word of the FPT shown below. 

word 



* X'OA' 



Device address 



1 2 3U 5 6 718 9 10 HT12 13 14 15116 17 18 19120 21 22 23T24 25 26 27T28 29 30 31 



word 1 



1 0- 



1 2 3 14 5 6 7 I 8 9 10 111 12 13 14 15T16 17 18 I9T20 21 22 23T24 25 26 27128 29 30 31 



ABNORMAL CODES AND MESSAGES 

The codes and messages for abnormal conditions that can 
occur when using the on-line diagnostics facilities are listed 
in Table 44. The abnormal code (bits 0-7) and subcode 
(bits 8-14)are returned in user's register SR3and the address 
of the procedure plus one word (CAL+1) is returned in user's 
register SRI. (The messages reside in the system error mess- 
age file, ERRMSG.) 

DDCB 

The format for the DDCB is given in Figure 16. Following 
each format, the parameter fields of the DDCB are described 
in alphabetical order by their mnemonic. All referenced 
addresses have word resolution. 
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Table 44. On- Line Diagnostics Abnormal Messages 



Abnormal 
Code 


Subcode 


Meaning of Code 


09 


00 


A diagnostic close is attempting to return a nonpartitioned device or a device within a parti- 
tioned controller. 


09 


01 


The device referenced in the DDCB is a nonexistent device. 


09 


02 


The device referenced in the DDCB is currently in use. 


09 


03 


The device referenced in the DDCB is currently in use by a symbiont. 


09 


04 


The DDCB does not contain a command list. 


09 


05 


The command list was invalidated by a swap. 


09 


06 


There are more than 12 I/O command doublewords (iOCDs). 


09 


07 


The I/O command list is invalid due to either invalid flags, an invalid TIC address, an invalid 
user-specified command list address, or insufficient room in the DDCB for the command list. 


09 


08 


An error was found during the BLIST CAL. Either an invalid page was found during physical-to- 
virtual or virtual -to-physical address conversion, the status address is in error, or the byte count 
is illegal in the IOCD. 


09 


09 


A buffer crosses a page boundary. 


09 


0A 


The user's ID does not match the ID specified on the last operator DIAG key-in, or the user 
privilege level was less than A0. 


09 


0B 


The amount of available core is not sufficient to allow the diagnostic program to lock itself 
in core. 


09 


OC 


The requested controller is not partitioned. 


09 


0D 


The device specifically requested on an open is not partitioned. 


09 


0E 


A MAP CAL error occurred due to an invalid page number during a physical-to-virtual or 
virtual-to-physical address conversion. 


09 


OF 


Monitor buffer space (MPOOL) is unavailable for processing the command list. 


09 


10 


A hand-coded TIO, TDV, or HIO type FPT does not have f3, f^, or f^ set to one when 
fo is one. 


09 


11 


A CHAN option on an MrDOPEN to a device type or operational label is illegal. 
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WordO 
















TTL 




F 
C 
I 


F 
C 
D 


W 
A 

T 


1 D i 


ASN = 3 


1 2 


3 14 5 6 7 


8 


9 


10 


11 


12 1314151 16 17 18 19120 21 22 23 1 24 25 26 271 


28 29 30 31 





FUN 


T 
O 

L 
F 



E 
V 
F 





TYPE 


DEV or OPLB 


12 3 14 5 6 7 


8 9 10 11112 13 14 


15 


16 


17 


18 19120 21 22 23 


24 25 26 27l28 29 30 31 



Word 2 






^^^^^^^^^^^B 





BUF 


12 3 14 5 6 7 


8 9 10 11112 13 14 


15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 



Word 3 



TIMEOUT 


$§S$§:SSwW:^ 


— I 1 . 

ERA 


12 3 14 5 6 7 


8 9 10 11112 13 14 


15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 



Word 4 






CLSZ 




ABA 


12 3 14 5 6 7 


8 9 10 11112 13 14 


15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 



Word 5 





















D 
I 

A 
G 


$i$ 


iililtl 




p 







T 
O 
P 









1 


2 


3 


4 5 


6 7 18 9 10 111 12 13 14 


15 


16 17 18 19120 21 22 23 


[24 25 


26 


27128 29 30 31 



Word 6 



FLP 



1 2 3 ?4 5 6 7 I 8 9 10 ll! 12 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27I28 29 30 31 



Word 7 




12 3 14 5 6 7 



14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 



Figure 16. Format of the DDCB 
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Word 8 



1 2 3 I 4 5 6 7 Is 9 10 11 1 12 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



Word 9 



(may not be used) 



24 25 26 271: 



12 3 14 5 6 7 



8 9 10 11112 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 



Word 10 



KBUF 



1 2 3(4 56 7"l"8 '""9 10 llll2 13 14 15 1 16 17 18 I9I2O 21 22 23 1 24 25 26 27 1 28 29 30 31 



Word 11 



COS or CIS 



C 

H 
A 

i N 



124 25 26 271: 



12 3 14 5 6 7 



8 9 10 11112 13 14 15 



16 17 18 19120 21 22 23 1 24 25 26 27128 29 30 31 



Word 12 



DEVICE 



1 2 3 14 5 6 7 18 9 10 11 1 12 13 14 15 1 16 17 18 191 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



Word 13 



12 3 I 4 5 6 7 fV'9 10 111 12 13 14 I5T16 17 18 I9I2O 21 22 23I24 25 26 27 1 28 29 30 31 



Word 14 



STA 



1 2 3 1 4 5 6 7 I 8 9 10 111 12 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 



Word 15 



TAB1 



1 2 3 I 4 5 6 7 18 9 10 11 1 12 13 14 15 1 16 17 18 19l 20 21 22 23124 25 26 27 1 28 29 30 31 
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Word 16 



*S*S 



W^- I ^ J j ! ;!:!;!! ! ^;:-!;:::.^^^ 






llfll 



■HBI 



HP 



75 1 2 3 I 4 5 6 7 18 9 10 11 1 12 13 14 1 511 6 17 18 19120 21 22 23124 25 26 27128 29 30 31 



Word 17 



SHWWSBfflSfcffi 



i£ 



; ** ? i 



T 



sSBG 






jiiUiliiUii 



1 2 3 14 5 6 7 18 9 10 11 112 13 14 151 16 17 18 19120 21 22 23124 25 26 27128 29 30 31 



Word 18 






M 






:-:*:*:h:o:ki-:&:^;v>Jtt^ :^w:::v^:':::^p-v:-: :■■ .- ■;■:■■■;■:■:-:-,■:■: ::;-:-:-p:-:::-:-. :-.;;■:■: : :M:::.:.::.:-:::.p:.:::::X: :■:■:■:■:-: v.v: ^ovXAWyovXv.vXv/x- -:■:■:■: : . ■:■.:■:■:■:■:■: : :■::■: :■:-:-:-:■- ,■:■■ :-..; 

1 2 3 14 5 6 7 18 9 10 11112 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 



Word 19 

■■■pimpiiminRff 



SWAPCT 



12314 5 6 7 18 9 10 11 1 12 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



Word 20 



RliJHif^rrlwjR'swBwws^^ 



% <\ 



^aiiiiiiiiiiiiiiiiiiiiJMi^^ 

1 2 3 14 5 6 7 18 9 10 1 1 1 12 13 14 15l 16 17 18 19 1 20 21 22 23124 25 26 27 1 28 29 30 31 



Word 21 








PRI 




CLIST 


1 2 


3 14 5 6 7 


8 9 10 ll!l2 13 14 


15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 



Words 22 — n are used for variable length parameters 
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FIELD 
ABA 

ASN 

BUF 

CHAN 

CIS 



DESCRIPTION 

Contains the address of the user's routine that will handle abnormal conditions resulting from 
insufficient or conflicting information. 

Indicates the assignment type currently in effect for the DCB (0 = null, 1 = file, 2 = Xerox 
labeled tape, 3 = device, X'A' = ANS labeled tape). 

Contains the address of a monitor MPOOL buffer used when processing the user's command list. 
Is the controller reservation flag (0 = no, 1 = yes). 

Contains the relative position of the serial number (in the SN list) of the magnetic tape reel 
used for current file input. 



WORD 



2 

11 
11 
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FIELD 



DESCRIPTION 



WORD 



CLIST Contains the virtual address of the physical command list in the DDCB. 21 

CLSZ Contains the number of words in the physical command list in the DDCB. 4 

COS Contains the relative position of the serial number (in the SN list) of the magnetic tape reel 11 
used for current file output. 

DEV Contains the DCT index of the device assigned to the DCB. DEV is only meaningful if DEVF 1 
is set to one. 

DEVF Indicates whether the DDCB is assigned to a device or an operational label (0 = operational 1 
label, 1 = device). 

DEVICE Contains the EBCDIC name specified on the DEVICE option in the M:DOPEN call. 12 

DIAG Indicates diagnostic device DDCB. 5 

DRC Is the format control flag and indicates whether (DRC = 0) or not (DRC = 1) the monitor is to do 
special formatting of records on read or write operations. DRC is always set to 1 in a DDCB. 

ERA Contains the address of the user's routine that will handle error conditions resulting from 3 
insufficient or conflicting information. 

FCD Indicates whether the DDCB is opened or closed (0 = closed, 1 = opened). 

FCI Indicates whether the DDCB has ever been closed. The flag is set when the DDCB is first closed, 
and then is never reset (0 = DDCB has never been closed; 1 = DDCB has been previously opened 
and closed). 

FLP Contains the address of the variable length parameters in the DDCB (called the file list-pointer). 6 

FUN Contains the device mode function (0 = null, 1 =IN, 2 = OUT, 3 = INandOUT, 4 = INOUT, 8=OUTlN). 1 

KBUF Contains the virtual address of the user's command list. 10 

OPLB Contains the OPLB table index of the operational label assigned to the DDCB. OPLB is only 1 
meaningful if DEVF equals 0. 

PRI Specifies priority of I/O request. 21 

STA Contains address of user data area used to return I/O status. 14 

SWAPCT Contains user's swap count at the time a diagnostic CAL is issued. 19 

TAB1 Contains the physical doubleword address of the command list in the DDCB. 15 

TIMEOUT Contains the I/O timeout value from the M:BLIST CAL. 3 

TOLF If 1, bits 16-31 of DDCB are TEXT OPLABEL. If 0, DEVF is meaningful. 1 

TOP If 1, opened to a device type or oplabel. Otherwise, set to 0. 5 

TTL Specifies the length of the DDCB in words. 

TYPE Contains the device type code assigned to the DDCB. This field is set whether the DDCB is assigned 1 
directly to a device or indirectly through an operational label. 

WAT Is the wait flag and indicates whether (WAT = 1 ) or not (WAT = 0) WAIT was specified for the I/O. 
WAT is always set to 1 in a DDCB. 



DDCB 125 



9. REAL-TIME PROCEDURES 



Real-time processing involves reacting to external events 
(including clock pulses) within microseconds. Selected ex- 
ternal events are allowed to interrupt the real-time user's 
program so that they can be processed at the time they 
occur. After an interrupt has been processed, control may 
then return to the interrupted program or may be directed 
elsewhere. 



Waiting 

Whenan interruptin the armed state receivesan interruptsig- 
nal, itadvances to the waiting state, and remains in the waiting 
state until it is allowed to advance to the active state. 

Enabled 



In CP-V real -time processing, there are three distinct types 
of interrupts: 

1 . Real, hardware interrupts. 

2. Multiple clock interval interrupts derived through soft- 
ware from a single hardware clock interrupt. 

3. User written pseudo- interrupts that are triggered by 
software rather than by hardware. This type of inter- 
rupt is quite useful for interprogram communication 
and synchronization. Pseudo-interrupts use interrupt 
addresses X'lOOG" through X7FFF'. 

Note : Any interrupt connected by real-time procedures 
must have a hardware priority below that of the I/O 
interrupt. Note also that the swapper performs I/O 
at a software priority of X'10 1 . (This would be a 
consideration when specifying a priority to be as- 
sociated with certain real-time I/O requests; e.g., 
M.-IOEX.) 

The counter-equals-zero interrupts (X'58' and 
X'59') may be connected to a user program via 
the M:CONNECT or MrGJOBCON procedures. 
However, it is the user's responsibility to initialize 
the corresponding counter pulse interrupts (X'52' 
and X'53'). 

CP-V real-time provides services that allow a user program 
to connect to and control interrupts, to request interruption 
at specified clock intervals, and to lock itself into core so 
that it will not be swapped out until it is ready to be 
swapped out. 

The following terms appear in the discussion of the real- 
time services: 



Disarmed 

When an interrupt is in the disarmed state, no signal to that 
interrupt is admitted; that is, no record is retained of the 
existence of the signal, nor is any program interrupt caused 
by it at any time. 

Armed 

When an interrupt is in the armed state, it can accept and 
remember an interrupt signal. The receipt of such a signal 
advances the interrupt to the waiting state. 



When an interrupt is in the enabled state, it is allowed to 
move to the active state when the interrupt signal is received 
provided that it is also in the armed state. If the interrupt 
is already in the waiting state, it moves to the active state 
when it becomes enabled, provided that no higher priority 
interrupt is currently active » 

Disabled 

An interrupt can undergo all state changes except that of 
moving from the waiting to the active state when it is in the 
disabled state. 

Active 



When an interrupt meets all of the conditions necessary to 
permit it to move from the waiting state to the active state, 
it is permitted to do so by being acknowledged by the com- 
puter, which then executes the contents of the assigned in- 
terrupt location as the next instruction. 

Cleared 

When an interrupt is changed from the active state to the 
cleared state, the interrupt states are reset so that the in- 
terrupt can be recognized again and the priority is reset to 
that of the job that was running when the interrupt occurred, 

Interrupt Control Blocks (ICBs) 

Areas of memory set aside for use by the monitor interrupt 
processing routines. ICBs are established by SYSGEN . 

Interrupt Label 

The two-character name of an interrupt. Interrupt labels 
are defined at SYSGEN. 

INTERRUPT CONNECTION AND CONTROL SERVICES 

CP-V real-time provides services that connect interrupts to 
mapped programs, control the state of interrupts (e.g., trig- 
ger, arm, enable, disable), clear interrupts either at time 
of occurrence or upon completion of processing, and discon- 
nect interrupts that are no longer required. Most of these 
services are provided through procedures which, except 
where noted, reside in 

SYSTEM RTPROCS 

and require real-time privilege (EO or higher). 
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CONNECT INTERRUPT TO GHOST FILE 

M'.GJOBCON The GJOBCON routine associates an 

interrupt with a load module such that if the interrupt oc- 
curs, the designated load module will be put into execu- 
tion as a ghost job. If the ghost job is already active as 
the result of a previous interrupt/ the interrupt will be 
ignored. An interrupt occurring while the ghost is asleep 
(M:WAIT) causes a wake-up event. 

The MrGJOBCON procedure call has the form 



M:GJOBCON (INT, Kf^bp^})/ 



c 



(LMN, 'load module') [, (ACN, 'account')] 



,(PRIO, Apriority)] 



where 



INT, L*jinterrupt specifies an interrupt address. 

INT, [*]'intlbl' specifies an interrupt label. If 

indirect addressing is used, the label must be in 
EBCDIC format, right-justified in the word, and 
preceded by blanks. 

LMN, 'load module' specifies the name of the load 
module to be placed in execution when the inter- 
rupt occurs. This will be the name of the re- 
sulting ghost job. The name must be seven char- 
acters or less in length. 

ACN # 'account' specifies the account of the load 
module and consequent running account for the 
ghost job. The default is the :SYS account. 

PRIO, [*J priority specifies the execution priority 
for the ghost job. The default is as follows: if 
'intlbl' was specified (via the INT keyword), the 
default is the SYSGEN-defined execution prior- 
ity associated within the interrupt label; if an in- 
terrupt address was specified (via the INT key- 
word) and the interrupt is a real interrupt, the 
default is n-X'4F' where n is the value of the 
interrupt address (e.g., programs attached to in- 
terrupt level X'60' would have a default execu- 
tion priority of X' 1 1'); if an interrupt address was 
specified (via the INT keyword) and the interrupt 
is a pseudo interrupt, the default is the SYSGEN- 
defined default execution priority for ghost jobs. 

Calls generated by the M:GJQBCON procedure have 
the form 

CAL1,5 fpt 

where fpt points to word of the FPT shown below. 



word 








* 




X'20' 

1 2 3 U 5 6 7 


0- 

8 9 


A 


Interrupt address 

Interrupt label (TEXT format) 

16 17 18 1?Im 21 22 23l24 25 26 27 1 28 29 30 31 


U 

10 111 12 13 14 IS 



word 1 



1 2 3 14 5 6 7 18 9 10 11112 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 



words 2 and 3 



Load module name in TEXTC 



format (S 7 characters) 



i 2 3 I 4 5 6 7 I 8 9 10 llll2 13 14 15 1 16 17 18 19 1 20 21 22 23 '.24 25 26 27 1 28 29 30 3 



words 4 and 5 (PI) 



Account name in TEXT 



format (S8 characters) 



i 2 3 I 4 5 6 7 I 8 9 10 11 1 12 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 3 



word 6 (P2) 



1 2 3 14 5 6 7 18 9 10 11 1 12 13 14 151 16 17 18 19120 21 22 23 



Priority 



24 25 26 27 1 28 29 30 31 



Condition code settings resulting from an M:GJOBCON 
CAL are: 

CC1 - set if the user does not have real-time 
privilege. 

CC2 - set if no interrupt control blocks are 

available. 



CC3 - set if the interrupt specified is already 

connected. 



CC4 - set if the ghostalready exists. This-M:GJOB- 

CON procedure call is ignored. 



CONNECT USER PROGRAM TO INTERRUPT 

M: CONNECT Any mapped user program with real -time 

privilege may use this service to establish a connection to 
an interrupt such that the user program will be entered at 
the specified address when the interrupt occurs. Interrupts 
connected in this way report events to the CP-V execution 
scheduler and therefore permit the entered program to use 
all monitor services. The connected interrupt will be armed 
and enabled or disabled as specified by the user. 
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The M:CONNECT procedure call has the form 
M:CONNECT (INT,H{|^^, pt }), 



word 1 



-(ENTRY,[*]address)[ # CLEAR][, MASTER] 



•[, DISABLE]^ (PRIO, [*]priority)j 



where 



INT, [*J interrupt specifies an interrupt address. 

INT, [*]'intlbl' specifies an interrupt label. If 

indirect addressing is used, the label must be in 
EBCDIC format, right-justified in the word, and 
preceded by blanks. 

ENTRY, [*]address specifies the address at which 
entry is to be made into the user program. 

PRIO,[*]priority specifies the execution priority 
for this interrupt. The default is as follows: if 
'intlbl' was specified (via the INT keyword), the 
default isthe SYSGEN-defined execution priority 
associated with the interrupt label; if an interrupt 
address was specified (via the INT keyword) and 
the interrupt is a real interrupt, the default is 
n-X'4F' where n is the value of the interrupt 
address; if an interrupt address was specified (via 
the INT keyword) and the interrupt is a pseudo 
interrupt, the default is the SYSGEN-defined 
default execution priority for either on-line, 
batch, or ghost fobs, depending on the mode 
in which the job is being executed. 

CLEAR specifies that the interrupt is to be cleared 
immediately upon occurrence and reported to the 
scheduler. The default is to leave the interrupt 
active. 

MASTER specifies that the user is to be given con- 
trol in the master mode. The default is the slave 
mode. 

DISABLE specifies that the interrupt is to be con- 
nected, armed, and disabled. The default is to 
arm and enable. 



Calls generated by the M:CONNECT procedure have the 
form 

CAL1,5 fpt 

where fpt points to word of the FPT shown below, 
word 



X'2V 



1 2 3 14 5 4 7 



8 9 10 11112 13 14 IS 



Interrupt address 

Interrupt labeT(TEXT format! 

16 17 18 1»1» 21 22 23l24 25 24 27I28 29 30 31 



"0 1 2 3 I 4 5 6 7 

word 2 



12 3 14 5 6 7 



word 3 (PI) 



8 9 10 111 12 13 14 15I 16 17 18 19l20 21 22 23(24 25 26 27I28 29 30 31 



Entry address 



8 9 10 111 12 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



Priority 



II 2 3 I 4 5 6 7 I 8 9 10 111 12 13 14 15 1 16 17 18 19 1 20 i\ 22 }3\U 25 26 27I28 29 36 31 

where 

M=l specifies MASTER mode. 

C=l specifies CLEAR. 

D=l specifies DISABLE. 

condition code settings resulting from an M-.CONNECT 
CAL are: 

CC1 - set if the user does not have real-time 

privilege. 

CC2 - set if no interrupt control blocks are avail- 

able. (Interrupt control blocks are estab- 
lished at SYSGEN.) 

CC3 - set if the interrupt specified is already 

connected. 

The environment existing for the real-time program at the 
time of the interrupt occurrence is saved in the user's TCB 
before entering the specified interrupt routine. The TCB is 
identical to the one shown in Figure 5 except that the last 
word contains the interrupt location rather than a trap 
location. 



DISCONNECT USER PROGRAM OR GHOST JOB 
FROM INTERRUPT 

M: DISCONNECT The DISCONNECT routine releases 

the specified interrupt if it is associated with the current 
user. If honored, the M:DISCONNECT procedure disarms 
the specified interrupt and releases the associated interrupt 
control block. 

The M.-DISCONNECT procedure call has the form 
M:DISCONNECT (INT, ^{l^b^}) 



where 



INT, [*] interrupt specifies the interrupt address. 

INT, [*]'intlbl' specifies the interrupt label. If in- 
direct addressing is used, the label must be in 
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EBCDIC format/ right-justified in the word, 
and preceded by blanks. 

Calls generated by the M:DISCONNECT procedure have 
the form 

CAL 1,5 fpt 

where fpt points to the FPT shown below. 



X'22' 



_ Interrupt address 

Interrup t la1aeT(TTXT Torma"tJ 



12 3T4"'5"6" 7 18 9 10 111 12 13 14 157 16 17 18 19120 21 22 23124 15 26 27128 29 30 31 

Condition code settings resulting from an MrDISCONNECT 
CAL are: 

CC1 - set if the user does not have real-time 
privilege. 

CC2 - set if the interrupt specified is not associ- 

ated with the current user. 

CC3 - set if the specified interrupt is currently 

active. 



CONTROL AN INTERRUPT 

M:INTC0N This service permits a program with real- 

time privilege to control the states of interrupts. Interrupts 
may be armed, disarmed, enabled, disabled, or triggered. 
If the designated interrupt is a pseudo-interrupt, the action 
specified does not affect any real hardware interrupt but 
is instead recorded in the associated interrupt control block. 
The use of this service does not require that the user 
issuing the M:INTCON request be connected to the desig- 
nated interrupt, thus permitting inter-user interrupts. 

The M:INTCON procedure call has the form 



M:INTCON aNTiHf^P 1 }), 



ARM, ENABLE] 

ARM, DISABLE 

DISARM 

ENABLE 

DISABLE 

TRIGGER 



whe 



INT, [*]interrupt specifies the interrupt address. 

INT, [*]'intlbl' specifies an interrupt label. If 
indirect addressing is used, the label must be in 
EBCDIC format, right-justified in the word, and 
preceded by blanks. 

ARM, ENABLE specifies that the interrupt is to be 
armed and enabled. 

ARM, DISABLE specifies that the interrupt is to be 
armed and disabled. 



DISARM specifies that the i nterrupt is to be disarmed. 

ENABLE specifies that the interrupt is to be enabled. 

DISABLE specified that the interrupt is to be disabled. 

TRIGGER specifies that the interrupt is to be 
triggered. 

Calls generated by the MrlNTCON procedure have the 
form 

CAL 1,5 fpt 

where fpt points to word of the FPT shown below. 

word 



X'23' 



Interrupt address 

Interrupt label (TEXT format) 

-• - - ~,] x -- -- - -I - s I 



1 2 3 14 5 6 7 8 9 10 11 1 12 13 14 15 16 17 18 19 1 20 21 22 23124 25 26 27128 29 30 31 



word 1 



0- 



Code 



1 2 3 14 5 6 7 I 8 9 10 1IH2 13 14 15116 17 18 19T20 21 22 23124 25 26 27 1 28 29 30 31 

where the 3-bit code has the following meanings: 
001 - DISARM 

010 - ARM and ENABLE 

011 - ARM and DISABLE 

100 - ENABLE 

101 - DISABLE 

111 - TRIGGER 

condition code settings resulting from an M:INTCON CAL 
are: 

CC1 - set if the user does not have real-time 

privilege. 

CC2 - set if the designated interrupt is not cen- 

trally connected (i.e., no M:CONNECT 
or M:GJOBCON has been performed on 
the interrupt). The requested operation is 
not performed in this case. 



GENERAL INTERRUPT INHIBIT 

M:INHIBIT This service permits a program with real- 

time privilege to prevent itself from being interrupted by 
any higher priority real-time task. Note that this is a soft- 
ware (not hardware) inhibit and applies to both real and 
pseudo interrupts. 
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The M:1NHIBIT procedure call has the form: 



M:INHIBIT 



{[bFF]} 



where 



ON specifies that the program is not to be interrupted. 

OFF specifies that the program may be interrupted 
and is the default. 



Calls generated by the M:INHIBIT procedure have the 
form 

CAL 1,5 fpt 

where fpt points to word of the FPT shown below. 

word 



X'23' 



1 2 3T4 5 6 7 T8 9 10 111 12 13 14 15 1 16 17 18 191 20 2! 22 23124 25 26 27128 29 30 31 



word 1 



o- 










f 








u 


1 


2 3 1 4 


6 


1 8 9 10 III 12 13 14 15 1 16 17 


18 19l20 21 22 23l24 25 26 27 1 28 29 30 


31 



where f specifies OFF if 0; or ON if 1. 

Condition code settings resulting from an M:INHIBIT CAL 
are: 

CC1 - set if user does not have real-time privilege. 



ARM[, ENABLE] specifies that the interrupt is to be 
left armed and enabled. (It is not necessary to 
specify ENABLE.) 

ARM, DISABLE specifies that the interrupt is to be 
left armed and disabled. (It is necessary to specify 
DISABLE.) 

DISARM specifies that the interrupt is to be left 
disarmed. 

None of the above options are recognized when exiting a 
clock-processing routine (see M:CLOCK below). 

Calls generated by the MrlNTRTN procedure have the 
form: 

CAL 1,9 X'OA' 

where the CAL instruction is as follows: 



X'04' 











X'OA' 



1 2 3l 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 191 20 21 22 23)24 25 26 27l 28 29 30 31 

where the 2-bit code has the following meanings: 

00 - LEAVE 

01 - DISARM 

10 - ARM and ENABLE 

1 1 - ARM and DISABLE 

When an error condition occurs, the user is aborted with an 
error code of either A301 or B802 (see Appendix B of the 
CP-V/BP Reference Manual, 90 17 64). 



RETURN FROM INTERRUPT PROCESSING 

M'.INTRTN This service allows a mapped, scheduled 

program entered as the result of a centrally connected in- 
terrupt or elapsed clock interval to return to the point of 
interruption. The actual return is to the environment that 
existed for this program or user when the interrupt occurred 
even if this user was not in control when the interrupt oc- 
curred. The environment that is restored was saved in the 
user's TCB at the time of interrupt entry. 

The M:INTRTN procedure call has the form 



M-.INTRTN 



fLEAVE 

ARM[, ENABLE] 
ARM, DISABLE 
DISARM 



where 



LEAVE specifies that the interrupt is to be left in 
its current state. LEAVE is the default for this 
procedure. 



QUEUE FOR INTERRUPT 

MlQFI This service permits the user to suspend execu- 

tion while awaiting interrupts or elapsed clock intervals as- 
signed a priority higher than the current execution priority. 
If there are no interrupts connected for this user that satisfy 
this condition, the user is aborted with a code of B8 and a 
subcode of 01. 

The M.-QFI procedure call has the form 

M : QFI 

Calls generated by the M:QFI procedure have the form 

CAL 1,5 fpt 
where fpt points to the FPT shown below. 



X'24' 



12 3 14 5 6 7 



8 9 10 111 12 13 14 TIT 16 17 18 19l 20 21 22 23F24 25 26 27T28 29 30 31 
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OBTAIN INTERRUPT STATUS 

M:IMTSTAT The service permits any user to query the 

status of any real or pseudo interrupt location. The format 
of the M:INTSTAT procedure call is 

M:INTSTAT ONT.Hf.Sf*} 



where 

INT, [*] interrupt specifies an interrupt address. 

INT, [*]'intlbl' specifies an interrupt label. If 
indirect addressing is used, the label must be in 
EBCDIC format, right-justified in the word, and 
preceded by blanks. 

The following word of information is returned to the user in 
general register 8: 



STAT 



USER 



GJOB# 



TS i 2 jfl 5 6 7 18 9 10 11 I 12 13 14 15 1 16 17 18 I9I2O 21 22 23l24 25 26 27 1 28 29 30 31 







where 



STAT indicates the status of the task associated 
with the interrupt location: 

STAT Meaning 

X'80' Task is active. 

X'40' Task is asleep or queued for interrupt. 

X'20' Task is waiting for I/O completion. 

X'10 1 Task is blocked and waiting for a 
resource. 

X'OT Specified interrupt is not currently 
associated with any user (i.e., 
inactive). 

USER is the user number of the user program which 
issued the M:CONNECT or M:GJOBCON. 

GJOB^ is the user number of the ghost job (if it is 
active) which will be entered upon the occur- 
rence of the interrupt. If the ghost job is not 
active, GJOB* contains zero. 

T specifies that the interrupt has been triggered, 
if set to one. 

E specifies that the interrupt is enabled, if set to 
one. 

A specifies that the interrupt is armed, if set to 
one. 



Calls generated by the M:INTSTAT procedure have the form 

CAL1,5 fpt 
where fpt points to the FPT shown below. 



X'27' 



Interrupt address 

Interru pt~IabeT~(TEXT format) 

'120 21 22 23I24 25 26 Z '"" "" "" 



01 2 3 I 4 5 6 7l8 9 10 111 12 13 14 15l 16 17 18 19l 20 21 22 23I24 25 26 27I2829 30 31 

Condition code settings resulting from an MrlNTSTAT CAL 
are: 

CC2 - set if the specified interrupt is not currently 
associated with any user (i.e., inactive). 
(The STAT field of general register 8 is set 
to 01.) 



LOCK IN CORE SERVICE 

M:H0LD Many real-time applications require that a 

program be held in core while various forms of special I/O 
occur. Since the CP-V scheduler will swap users as con- 
ditions require in order to keep as many executable users 
in core as possible, it is necessary for those real-time pro- 
grams which require extended core residency to identify 
themselves via the M:HOLD service. 

The format of the M:HOLD procedure call is 



M.-HOLD 



JON 
lOFF 



J [, PURGE] 



wher 



ON specifies that swapping is to be prevented for 
this user (i.e., the user is to be locked in core). 



OFF 



releases the hold. 



PURGE specifies that the user's pages should not be 
released if the user exits (or aborts) while locked 
in core. 

Condition code settings resulting from an MrHOLD call are: 

CC1 - set if user does not have real-time privilege. 

CC2 - set if there is not enough room left in core 
to hold the routine that allocates new disk 
space or the routine that communicates with 
thesymbiont ghost. Any monitor service that 
invokes these routines must not be used in 
this case. 

Restrictions: 

1. The user must have real-time privilege. 

2. All memory management services which increase this 
user's size and the M:LINK and M:LDTRC services will 
not be allowed once the user is held in core. 



Lock in Core Service 



131 



3. Monitor services may be further restricted if CC2 is 
set. All services requiring the allocation of new disk 
space or communication with the symbiont ghost are 
prohibited for the user. 

It is important to note that any program using MrHOLD 
should take exit control to cover abort conditions because 
if an abort or exit occurs while the user is locked in mem- 
ory, the memory involved will not be released if PURGE 
was specified. 

Calls generated by the MrHOLD procedure have the form 

CAL1,5 fpt 
where fpt points to the FPT shown below. 



X'25' 



1 2 3 14 5 6 7 18 9 10 11112 13 14 15 MA 17 18 19120 21 22 23124 25 26 27128 29 30 31 

where 

fj specifies ON if set to or OFF if set to 1. 
f 2 specifies PURGE if set to 1. 

clock Service 

MrCLOCK This service permits a user with a privilege 

level^o f 80 or higher to request entry at a specified address 
when a specified time interval has elapsed. The format of 
the MrCLOCK procedure call is: 

MrCLOCK (ENTRY, fladdress), . 

1 [CANCEL 

{(INTERVAL, [*]units)[, (PRIO, [*]priority)J , 



[,ONESHOT][, MASTER]] 

where 

ENTRY, [*]address specifies the address at which 
the user is to be given control when the specified 
interval has expired. The environment existing 
for the user at the time of the interval expiration 
is saved in the user's TCB as described under 
M:CONNECT. 

CANCE L causes any outstanding M :CLOC K requests 
for the specified entry address to be canceled. 

INTERVAL, [*]units specifies the time interval in 
two-millisecond units. 

PRIO, [*] priority permits users with real-time pri- 
vilege to specify the software priority. This 
option is ignored if the user does not have real- 
time privilege. 

ONESHOT cuases the M:CLOCK request to be 
automatically canceled after one occurrence. If 
ONESHOT is not specified, the interval timing is 
to be automatically repeated until CANCELed. 

MASTER specifies that the user will be given con- 
trol in the MASTER mode. (This is only honored 



if the user has real-time privilege.) The default 
is the SLAVE mode. 

Calls generated by the M:CLOCK procedure have the form 

CAL1,5 fpt 

where fpt points to word of the FPT shown below. 

word 



X'26' 



|ntry address 



1 2314567 T8 9 10 11 1 12 13 14 15 1 16 17 18 19120 21 22 23124 25 26 27T28 29 30 31 



word 1 



12 3 I 4 5 6 7\i 9 10 111 12 13 14 15 1 16 17 18 I9I2O 21 22 23 1 24 25 26 27I28 29 30 31 

word 2 (PI) 



Timer units 



1 2 3 14 5 6 7 18 9 10 111 12 13 14 151 16 17 18 19120 21 22 23124 25 26 27T28 29 30 31 



word 3 (P2) 



Priority 



1 2 3 14 5 6 7 18 9 10 11 1 12 13 14 15 1 16 17 IB 19120 21 22 23124 25 26 27126 29 30 31 

where 

M specifies MASTER mode if set to I. 

O specifies ONESHOT if set to 1. 

C specifies CANCEL if set to 1. 
Condition code settings resulting from an MrCLOCK CAL 



CC1 - set if no interrupt control blocks are 

available. 

CC2 - set if no interrupt control block is associ- 

ated with the user's entry address when 
CANCEL is specified. 

CC3 - set if user does not have a privilege level 

of at least 80. 



DEVICE PREEMPTION SERVICES 

PREEMPT DEVICE 

M:ST0PI0 Certain real-time applications require that 

there be direct control over the I/O associated with a par- 
ticular device and that there be no contention for a parti- 
cular device during certain critical processing periods. This 
includes the ability to request I/O end action off of the 
I/O interrupt associated with the I/O operation. 
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The real-time user may request that a specific device be 
preempted from use by any user other than a real-time user 
doing direct I/O to the device via the MrSTOPIO service. 
The following types of devices may not be preempted. 

Teletypes (i.e., Operator's Console) 

COC Devices 

Public RADs 

Public Disk Packs 

The format of the M:STOPIO procedure call is 

where 

DCB, [*Jdcb adr specifies that the device associated 
with this currently open device-type DCB is to be 
preempted from use by any other user. Only the 
user requesting the STOPIO may perform subsequent 
I/O to the device. 

DEV, L*jX 'device adr' specifies which device is to 
be preempted from use by all but this user and is 
one of the following: 

ndd - a 12-bit physical address as used by 
Sigma hardware. 

cudd - a 14-bit physical address as used by 
Xerox 560 hardware (cluster/unit/ 
device). 

EA, ["jvadr is the virtual address of a routine that is 

to handle any I/O interrupts from the device being 
preempted. This address is converted to a physical 
address and stored in the DCT tables. Therefore 
the user, prior to issuing the MrSTOPIO request, 
must have locked himself in core via the M:HOLD 
CAL. This routine is entered master mode, un- 
mapped, via a BAL on register 1 1 with the I/O 
interrupt active (high). Register 1 contains the 
AIO status of the interrupting device; register 2 
contains the right-justified address of the interrupt- 
ing device; byte of register 3 contains the con- 
dition codes as set by the AIO instruction; regis- 
ters 4and 5 contain the TIO status of the interrupt- 
ing device with byte of register 4containing the 
condition codes as set by the TIO instruction; 
register 6 contains the physical address of the 
(user's) end-action-receiving routine; and register 7 
contains the DCT index of the interrupting device. 
No monitor services may be requested by the re- 
ceiving routine. All registers may be considered 
volatile except register 11 through which return 
to the monitor must be made. 

The DCB form of the M:STOPIO procedure call should be 
used whenever the user depends upon the operator to mount 



removable volumes on private spindles or tape drives. The 
DEV form should be used whenever the user wants a non- 
standard device or a symbiont-type device (e.g., LP, CR, I 
CP, RBT). Use of the DEV form to preempt any other device 
type results in an abnormal return (see the condition code 
settings below). 

Calls generated by the MrSTOPIO procedure have the form 

CAL 1,5 fpt 

where fpt points to word of the following FPT. 

word 



* X'lC 



0- 



DCB/device address 



01 2 3 I 4 5 6 7 I 8 9 10 111 12 13 14 15116 17 18 1? 1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



word 1 



0- 


o| f , f , 


1 




1 


2 3 U 5 6 7 1 8 9 10 111 12 13 14 15M6 


17 


18 I9I2O 21 22 23l24 25 26 27 1 28 29 30 31 



word 2 



End action address 



01 2 3 U 5 6 7 I 8 9 10 111 12 13 14 15116 17 18 l»l 20 21 22 23 1 24 25 26 27I28 29 30 



where 

f specifies DEV if or DCB if 1. 

f_ indicates that EA was not specified if or that 

EA was specified if 1. 

The return from the procedure call is to CAL+1 with the fol- 
lowing possible condition code settingsr 

1234 

device successfully preempted. 

1 user doesn't have real-time privileges; or the 
physical EA address is greater than 128K 
(Xerox 560 only). 

10 requested device is not preemptable (i.e., a 
public pack or RAD), is already preempted by 
another user, the specified DCB is nonopened 
properly, or there was an illegal use of the DEV 
form. 

10 unknown device address; request ignored. 

10 requested device was associated with a sus- 
pended symbiont; request ignored. 

Should the application require that the multi-device con- 
troller (associated with the device to be preempted) also be 
preempted, the SYSCON processor should be used. This 
would imply that the application cannot tolerate any con- 
tention for either the particular device or the multi-device 
controller associated with that device (tape drive or private 
disk pack). In the case of a disk pack controller, the 
spindles associated with that controller must have been de- 
signated as private. 
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RETURN PREEMPTED DEVICE 

MsSTARTIO Any preempted I/O device may be returned 

to the system via the MrSTARTIO service. 

The format of the MrSTARTIO procedure call is 
( M:START,o{^ ; H^) adr , )} 

where deb adr and device adr are as described under 
M:STOPIO. 

Calls generated by the M:STARTIO procedure have the form 

CAL1,5 fpt 

where fpt points to word of the FPT shown below. 

word 



* X'lD' 



0- 



DCB/device address 



1 2 314 5 6 7 I 8 9 10 11! 12 13 14 !5ll6 17 18 19120 21 22 23124 25 26 27128 29 30 3) 



word 1 



1 



1 2 3T4 5 6 7 18 9 10 11112 13 14 15 



f 



16 17 18 19120 21 22 23124 25 26 27128 29 30 31 



where f specifies DEV if or DCB if 1. 

The return from the procedure call is to CAL+1 with the fol- 
lowing possible condition code settings: 



12 3 4 



1 

10 

10 
10 



device successfully returned. 

user doesn't have real-time privileges. 

device wasn't preempted by this user, or the 
specified DCB is not opened properly, or there 
was an illegal use of the DEV form. 

unknown device address; request ignored. 

device was busy; request ignored. 

DIRECT I/O SERVICES 

I0EX SERVICES 



The M:IOEX service is provided as one means of enabling 
the real-time user to exercise direct control over I/O op- 
erations without having to run in the master mode (see also 
the M:EXU service). The only requirements are that the 
device specified be preempted (either via the MrSTOPIO 
service or the SYSCON processor), and that an end-action 
routine be provided (either via MrSTOPIO or M:IOEX). The 
I/O functions that can be controlled via M:IOEX are: 

SIO — Start input/output. 



HIO - Halt input/output. 
TIO —Test input/output. 
TDV — Test device. 



M: 10 EX (SIO) 

call is 



The format of the M-.IOEX(SIO) procedure 



M . nFy f(DCB, Hdcbadr) 1 

M,IOEX l(DEV,0X'deviceadr')J' 



-(SIO, [*]clist[,REL])[,(EA, [*]vadr)] 



-Q(TO,[*]value)[,(PRI,[*]prio)] 



/here 



DCB,[*]dcb adr specifies that the I/O function is 
to be performed for the device associated with the 
currently open DCB addressed. 

DEV, [*]X 'device adr 1 specifiesthe device for which 
the I/O function is to be performed and is one of 
the following: 

ndd —a 12-bit physical address as used by 
Sigma hardware. 

cudd —a 14-bit physical address as used by 
Xerox 560 hardware (cluster/unit/ 
device). 

SIO,[*]clist is the starting virtual address (double- 

word bound) of the I/O command list to be initiated. 
All buffer addresses within the command list itself 
must be physical addresses. The channel program 
must request a "Channel End Interrupt" (unless REL 
has been specified, see below); however, multiple 
interrupts per I/O requests are permitted (e.g., 
"Zero Byte Count Interrupt" and "Channel End 
Interrupt"). 

REL specifies that the channel is to be released af- 
ter issuing the SIO. This would be used with 
command lists which do not result in data transfer 
operations (e.g., seek orders, rewind orders, head- 
positioning orders). 

EA, [*Jvadr is as described under M.-STOPIO; the 
M:HOLD requirement applies to M:IOEX also. 

TO, [Rvalue is the number of 4.8 second intervals 
allowed to elapse following the issuance of the SIO 
instruction before the EA address will be entered. 
In this case, the user's EA routine is entered master 
mode, unmapped, via a BAL on register 11 with 
registers 1 and 2 equal to zero. Register 7 contains 
the DCT index and register 6 contains the physical 
address of the (user's) end-action-receiving routine. 
Byte of register 3 contains the condition codes as 
set by the SIO instruction; registers 4 and 5 con- 
tain the SIO status registers' information. No mon- 
itor services may be requested by the receiving 
routine. All registers may be considered volatile 
except register 1 1 through which return to the mon- 
itor must be made. A time-out value of zero 
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implies that no time-out facilityis desired (default), 
however the user's EA address will always be en- 
tered should an SIO failure occur (in this case 
register 1 will be nonzero). 

PRI, Hprio is the priority at which to queue the 
request and is a value between and X'FF'. The 
default is the value of the user's current execution 
priority. 



Table 45 summarizes the various possible register settings 
for end-action routines. 

Calls generated by the M:IOEX (SIO) procedure have 
the form 

CAL1,5 fpt 

where fpt points to word of the FPT shown below, 
word 



X'lE' 



Fl 2 3 \* 5 6 7 



DCB device address 



8 9 10 11 1 12 13 14 15 1 16 17 18 19 1 20 21 22 23! 24 25 26 27 1 28 29 30 31 



word 1 



4 5 6 7 18 9 10 lTTl2 13 14 15 



1* 17 18 19120 21 22 23124 25 26 27128 29 30 31 



word 2 



* 



Command list address 



1 2 3 I 4 5 6 7 i 8 9 10 11 1 12 13 14 151 16 17 18 19 1 20 21 22 2sl24 25 26 27 1 28 29 30 



word 3 (PI) 



End-action address 



1 2 3U 5 6 7 I 8 9 10 llll2 13 14 15ll6 17 18 19l20 21 22 23l24 25 26 27l28 29 30 31 



word 4 (P2) 



* 



1 2 3 14 5 6 7 18 9 10 11 1 12 13 14 151 16 17 18 19120 21 22 23 



Time-out 
value 



24 25 26 27 1 28 29 30 31 



word 5 (P3) 



Priority 



01 2 3 I 4 5 6 7 18 9 10 11112 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 

where 

fl specifies DEV if or DCB if 1. 

f2 is set to 1 if RE L was specified on SIO. 

The return from the procedure call is to CAL+1 with the fol- 
lowing possible condition code settings: 

I/O request successfully queued. 

1 user doesn't have real-time privileges. 

10 specified device doesn't exist or the specified 
DCB is not opened properly. 

10 EA was not specified and the DCT tables do not 
contain the address of an end-action receiver; 
or the physical address EA is greater than 128K 
(Xerox 560 only). 

10 specified device is not preempted, or has been 
preempted by another user. 



Table 45. Register Settings for End-Action Routines 



Register 


Contents when Routine Entered 
due to Interrupt 


Contents when Routine Entered due to 
Timeout or SIO Failure 


R0 


- 


- 


Rl* 


AIO status. 


0= timeout; Nonzero = SIO failure. 


R2* 


Device address. 





R3 


AIO condition codes (byte 0). 


SIO condition codes (byte 0). 


R4 and 
R5 


TIO status; byte of R4 contains the 
condition codes from TIO. 


SIO status (if timeout). R4 contains the 
doubleword address of the failing channel 
program (if SIO failure). 


R6 


Physical address of EA routine. 


Physical address of EA routine. 


R7 


DCT index. 


DCT index. 


Rl and R2 indica 


te how the end-action routine was entered. 
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M:IOEX (HIO/TIO/TDV) The format of the M:IOEX 

(HIO/TIO/TDV) procedure call is 



M:IOEX 



f(DCB, T*]dcb adr 
l(DEV, J^X'device adr') 



,■>}• 



HIO 

no 

.TDV 



where deb adr and device adr are as described under 
M:IOEX. 

Calls generated by the M-.IOEX (HIO/TIO/TDV) procedure 
have the form 

CAL 1,5 fpt 

where fpt points to word of the following FPT. 



word 








* 


X'lF' 


0- 




DCB/device address 


u 





123)4567 


8 9 


10 111 12 13 14 


15ll6 17 18 19 1 20 21 22 23(24 25 26 27 1 28 29 30 31 



word 1 



0- 




f 


1 

n n 


Code 


u 


u u 


1 


2 3 1 4 5 6 7 18 9 10 1 1 1 12 13 14 15 


16 


17 18 I9I2O 21 22 23l24 25 26 27 


28 29 30 31 



where 

code is: 

if TIO 

1 if TDV 

2 if HIO 

f specifies DEV if or DCB if 1. 

The return from the procedure call is to CAL+1 with the 
condition codes and registers set as if the user had issued 
the following instruction: 



HIO] 

TIO 

TDV. 



,8 X'device address' 



Since the condition codes cannot be used to communicate 
abnormal conditions for any of the above three services, 
any of the abnormal conditions indicated below will result 
in a program abort (code B9, subcode as indicated). Such 
aborts may be intercepted by the user via TRAP control 
(M:TRAP procedure call specifying CAL). 

Subcode Meaning 



01 
02 



User doesn't have real-time privilege. 

Specified device doesn't exist, is not pre- 
empted by this user, or the specified DCB is 
not opened properly. 



EXECUTE PRIVILEGED INSTRUCTION SERVICE 

M'.EXU The M:EXU service is provided as another way 

to enable the real-time user to execute I/O instructions 
and other privileged instructions without having to run in 
the master mode (see also the M.-IOEX Service). The only 
requirement is that the instruction op code to be executed 
be one of the following-. 



Op Code 


Mneumonic 


X'4C 


SIO 


X'4D' 


TIO 


X'4E' 


TDV 


X'4F' 


HIO 


X'6C 


RD 


X'6D' 


WD 



The SIO execution service is intended primarily for inter- 
facing to devices not known to the operating system (DCT 
tables) and which do not generate I/O interrupts (X'5C). 
However, no validity checks are made and if the SIO will 
result in an I/O interrupt, it is assumed that the user will 
have provided an end-action receiver via the M:STOPIO 
service. 

For a complete discussion of the M:EXU service, see the 
CP-V/BP Reference Manual, 90 17 64. 



ENTER MASTER MODE 

MlMASTER The M:MASTER procedure allowsa user with 

sufficient privilege level (CO or higher or the MS privilege) 
to operate in the master mode (master-protected mode if 
running on a Sigma 9 or Xerox 560) with a write key of 1. 
(This procedure resides in SYSTEM BPM. ) The format of the 
procedure call is 

M:MASTER 

Calls generated by the M:MASTER procedure have the form 
CAL 1,5 fpt 

where fpt points to the FPT shown below. 



X'08' 



1 2 3 14 5 6 7 



8 9 10 11112 13 14 15ll6 17 18 I9I 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



If the caller's privilege level is not sufficient, return is to 
CAL+1 with CC1 set. 



ENTER SLAVE MODE 

M'.SLAVE The M:SLAVE procedure allows any master 

(and master-protected) mode program to return to the slave 
mode. (This procedure resides in SYSTEM BPM.) The for- 
mat of the procedure call is 

MrSLAVE 
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Calls generated by the M:SLAVE procedure have the form 
CAL1,5 fpt 

PSECT DIRECTIVE 

The Meta-Symbol PSECT directive specifies that the control 
section which follows is to begin on a page boundary. The 
directive can be useful for controlling the placement of I/O 
buffers, data, and end-action-receiving routines which will 
be accessed unmapped. 

VIRTUAL/PHYSICAL ADDRESS CONVERSION 

M:MAP The M:MAP procedure converts a specified 

virtual address to a physical address or a specified physical 
address to a virtual address. The converted address is stored 
in general register 8. The M:MAP procedure call has the 
form: 



MrMAPJp^}, (ADR, [*]address) 



where 

VTP specifies virtual to physical address conversion. 

PTV specifies physical to virtual address conversion. 

ADR, J*jaddress specifies the location of the ad- 
dress to be converted. 

M:MAP should be used with MrHOLD since the address 
returned via M:MAP may not be valid if a swap occurs. 

Calls generated by the M:MAP procedure have the form 
CAL1,6 fpt 

where fpt points to word of the FPT shown below. 

word 



X'02' 



Address 



1 2 3 14 5 6 7T8 9 10 11U2 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 



word 1 



f 



1 2 3 14 5 6 7 18 9 10 11 1 12 13 14 15T 16 17 18 19 20 21 22 23l24 25 26 27128 29 30 31 

where f indicates virtual to physical address conversion 
(f = 0) or physical to virtual address conversion (f = 1). j 

If the user's privilege level is not at least A0, the return is 
to CAL+1 with CCT set. I 



MISCELLANEOUS REAL -TIME SERVICES 

The following is a set of services provided to master mode, 
mapped or unmapped real-time programs. These services 



are provided via Meta-Symbol procedure references that 
result in BAL linkages to monitor routines (hence the master 
mode requirement) as opposed to CAL1 linkages. The rou- 
tines entry points are REFed as a result of the various pro- 
cedure calls, therefore the program must be loaded with 
reference to the MONSTK or Jl files in order to satisfy 
these external references. All user registers are preserved 
by pushing them into TSTACK except as indicated for 
specific services. 



GET OR FREE PHYSICAL PAGE 

M:GPP The M:GPP procedure acquires a physical page 

of memory. The procedure call has the format 

M:GPP 

On return from the procedure, general register 3 contains 
the physical page number of the newly allocated page of 
memory or the value zero if none was available. 

In order for a mapped user to reference a physical page 
acquired by M:GPP, it is necessary to perform a Change 
Virtual Map (M:CVM) specifying the physical address of 
the page acquired by M:GPP and the virtual address into 
which this page is to be mapped. 



M:FPP The M:FPP procedure releases a physical page 

of memory that was acquired by M:GPP. The procedure 
call has the format 

M:FPP [*]page 

where page specifies the physical page number of a page of 
memory which is to be returned to the system. 

It isthe user's responsibility toreturnany pages obtained via 
M:GPP since the system keeps no record of this transaction. 



INITIATE GHOST JOB 

M:GJ0B The M:GJOB procedure activates (or awakens) 

a program as a ghost job. The format of the procedure is 

M:GJOB (LMN, loc)[, (ACN, loc)][, (PRI,[*J value)] 

where 

LMN, loc specifies the location containing the name 
of the program to be activated (or awakened) as a 
ghost job. The name must be in TEXTC format and 
must not be greater than 7 characters in length. If 
the name is less than four characters, a word of 
blanks (X'40's) must immediately follow the name. 

ACN, loc specifies the location containing the name 
of the account in which the program exists. The 
account name must be in TEXT format, left-justified 
with trailing blanks to occupy two words. The 
default is the :SYS account. 
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PRI, [*]value specifies the execution priority to be 
associated with the ghost job. The default priority 
will be that defined for ghost jobs at SYSGEN. 

On return, CC1 is set if it was not possible to initiate the 
specified ghost at this time because either ghost job table 
space was not available or user table space was not avail- 
able. CC1 and CC3 are set if the specified ghost was cur- 
rently running. CC2 is set if the specified ghost job was 
asleep or queued for interrupt and was awakened. Other- 
wise, the condition codes are all set to zero. 



To load or store a relative sector number: 



{LSECTA \ , , 
lSTSECTAl' oddregre9 



where 



oddreg is the odd numbered register to be loaded 

or stored. (Register 15 may not be specified. ) 

reg is any register except the one selected for 
'oddreg' or 15. 



GET AND RELEASE DISK GRANULE 

M:GDG The M:GDG procedure dynamically acquires 

a disk granule. The procedure has the format 

M:GDG 

The starting disk address of the acquired granule is returned 
to the user in general register 8 in the following format 





E 


DCTX 


1 

RSN 


1 2 3 1 4 5 6 7 


8 


9 10 111 12 13 14 15 


16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



The disk address shown above is in standard format for disk 
addresses in CP-V, where: 

E is the extension bit necessary to represent a 

17-bit relative sector number on large capacity 
disk packs. 

DCTX is the DCT index for the device. 

RSN is the 16-bit relative sector number. 

If no granule is available, register 8 is set to zero. 

Note: Currently, E (in the disk address shown for M:GDG) 
is a single bit. In the future Xerox may add disk 
packs which require 18 bits in order to represent the 
highest relative sector number. Therefore it is rec- 
ommended that users utilize the following procedures 
(referenced via the SYSTEM UTS directive of Meta- 
Symbol preceded by a DISCBPROC SET 1 directive) 
when referencing disk address fields. 

To load or store a DCT index, use 
{s?DCTx}' r[W]locr ' indexJ 



rher 



r is the register to be loaded (stored). 

loc is a location, or optionally, a pointer to a 

location, containing (destined to contain) the 
disk address (see index below). 

index is an index register containing a word dis- 

placement which, when added to the address 
given by loc, yields an effective address contain- 
ing (destined to contain) the disk address. 



Note that it is the user's responsibility to return any gran- 
ules obtained via M:GDG since the system keeps no record 
of this transaction. 

M:RDG The M-.RDG procedure dynamically releases a 

granule acquired via M:GDG. The procedure has the format 

M-.RDG [*]disk address 

where disk address is the starting address of the disk granule 
to be returned to the system. It must have the same format 
as described for M:GDG. 

Under certain conditions, the monitor may not be able to 
accept a granule from the user at a particular time. In this 
case, register 8 will contain a zero indicating that the user 
must try again. 



REPORT USER EVENT 

M.'RUE The M:RUE procedure reports an event on a 

particular user (i.e., it simulates that the event took place 
for the user). The format of the procedure call is 



M:RUE (UN^Muser^^EV,!^}) 



where 



user 



# 



is the number of the user for whom the event 
is to be reported. A user may determine his own 
user number (for purposes of communicating this 
to other programs) by referencing the monitor cell 
S:CUN (Current User Number) which is located in 
page of the monitor and is therefore available 
to any user program loaded with MONSTK. 

event is one of the following symbols signifying the 
event to be reported on the user: 



Symbol 


Event 


Resulting Action 


E:CBK 
E:OFF 


BREAK 
Log -off 


Control passes to the user at 
the address specified via an 
M:INT procedure call. 

The user is deleted from the 
system. 



tts 
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Symbol 


Event 


Resulting Action 


E:ERR 


Error 


The user is errored and de- 
leted from the system. 


E:WU 


Wake-up 


The specified user is scheduled 
for execution and reentered 
at the instruction following 
the M:WAIT CALL 


E:UQA 


Unqueue 

for 

access 


The specified user is scheduled 
for execution and reentered 
at the instruction following 
the CAL1 which caused him 
to be queued for access. 



loc2 is a word location containing the value as- 
sociated with the event symbol (defined by the 
assembly SYSTEM). 

Note; Care must be taken to ensure that the user for whom 
the event is being reported is in the appropriate 
state since an illegal current state/event combi- 
nation will cause the system to crash. E:CBK # 
E:OFF, and E:ERR may be safely reported on a user 
at any point in time. 



CHECK INTERRUPT STATUS 

MsCHKINT The McCHKINT procedure checks the status 

of an interrupt. The format of the procedure call is: 

M:CHKINT (INT,[*]int) 

where int is the location of a word containing the address 
of the interrupt to be checked. 

The following word of information will be returned to the 
user in general register 8: 



STAT 



USER 



GJOB# 



0" 1 2 3 I 4 5 6 7 I 8 9 10 111 12 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27I28 29 30 31 



where 
A 

E 

T 



specifies, if set # that the interrupt is armed. 

specifies, if set, that the interrupt is enabled. 

specifies, if set, that the interrupt has been 
triggered and the interrupt processing routine has 
not yet finished. 

STAT indicates the status of the task associated 
with the interrupt location as follows: 

STAT Meaning 

X'80' Task is active. 

X'40' Task is asleep or queued for interrupt. 



STAT Meaning 

X'20 1 Task is waiting for I/O completion. 

X'10' Task is blocked, waiting for a resource. 

X'01 1 Specified interrupt is not currently asso- 
ciated with any user (i.e., inactive). 

USER is the internal user table index for the user 
currently associated wit+i this interrupt. 

GJOB# is the user number of the ghost job (if it is 
active) which will be entered on the occurrence 
of the interrupt. If the ghost job is not active, 
GJOB* contains zero. 

I/O SERVICES 

The following services result in BAL linkages to the monitor's 
I/O Supervisor module (IOQ). They are separated into 
three types: 

1. I/O without a DCB where the user supplies the channel 
program (M:EXCP). This should be used only where no 
handler exists for a particular device or the user re- 
quires unusual control over the device. 

2. I/O without a DCB while not requiring the user to build 
his own channel program (M:NEWQ). 

3. I/O with parameters supplied ina pseudo DCB (M:QUE). 

Special problems exist when applying these techniques to 
disk I/O. Unless the volume is being managed entirely by 
the user, the user must be aware of the physical location 
of the data on the disk volume (or volumes). A random file 
would be the most common way of allocating space on a 
public or private volume for use by both privileged and non- 
privileged users. A random file is allocated contiguously 
on a public or private volume when it is opened. By speci- 
fying the F PA RAM option on the M:OPEN call to an exist- 
ing file, the user requests the monitor to pass the file attri- 
bute (FIT table) parameters to a specified location (see the 
DCB discussion in Appendix A of the CP-V/BP Reference 
Manual, 90 17 64). FDA (First Disk Address) is returned in 
word one of the X'OO — coded FIT entry. File size (in 
granules) is given in word one of the X'OD 1 — coded FIT 
entry. 

Flawed tracks are automatically taken care of by the I/O 
system assuming that the requested byte count does not cause 
the transfer to cross a track boundary from a good track to 
a flawed track. If the user ensures that all tracks are good, 
the hardware will automatically handle the case in which a 
track boundary is crossed. However, the user must handle 
the cylinder overflow condition himself. (A new seek must 
be issued between accessing the last sector of one cylinder 
and the first sector of the next cylinder. ) 



CALCULATING PHYSICAL ADDRESSES 

All of the I/O procedure calls described below are avail- 
able to the mapped or unmapped user. Several require that 
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physical addresses by passed. For all mapped users, the 
user may convert a virtual address to a physical address by 
using the M:MAP procedure call described previously. 

In order to ensurethat a mapped user is not swapped between 
the time that the physical address is calculated and the 
time the I/O is requested, the MrHOLD (Lock in Core) 
service should be performed. 

Note, however, that a mapped, master mode program is 
assured of not being swapped as long as it does not request 
any monitor services via CALls. 



EXECUTE CHANNEL PROGRAM 

M:EXCP The MrEXCP procedure causes the user's own 

channel program to be executed. The format of the pro- 
cedure call is 



M:EXCP (CPA,{^ loc) j),(DCT, [*]index)- 



c 



[,(PRI, [*Jpriority)][,(EA,[*]loc 



[,[*]eai])][,(TOI,[*]value)] 



where 



DA(loc) specifies the physical doubleword address 
of the start of the channel program. 

*loc specifies the word address of a word which 
contains the physical doubleword address of the 
start of the channel program. (The asterisk is 
required. ) 

DCT, [*]index is the DCT index of the device 
associated with the channel program. 

PRI, [*] priority is the priority to be associated 
with the requested I/O operation. Priority re- 
quests range from to X'FF' (highest to lowest). 
Priorities in the range of to X'BF' are treated 
as real-time priority requests; X'CO' to X'FF' are 
treated as background priority requests. The only 
system I/O that operates at a real-time priority 
is swapping I/O (priority = X'10'). The default 
priority is X'FF'. 

EA, [*]loc is the physical address of the user's 
end-action routine. 



eai is a word of end-action information. This 

information is passed back to the user's end-action 
routine. 

TOI, [*J value is a time-out value specified in 
five second increments. The default value is 
five seconds. 



The user's end-action routine (if specified) is entered 
unmapped, via a BAL on register 11. All registers may be 
considered volatile (except register 11, through which re- 
turn is made to the monitor). The following information is 
passed to the end-action routine.- 



Register 




Bit Fields 


Contents 


7 




24,8 


-,DCT 


12 




8,8,16 


TYC, -, RBC 


13 




16,16 


-,CCA 


14 




32 


EAI 


15 




13,19 


-,BUF 


where 








DCT 


is the 


DCT index. 





TYC is the type of completion code returned by 

the device handler. 

RBC is the remaining byte count. 

CCA is the current IOP command address. 

EAI is the end-action information specified in the 
procedure call. 

BUF is the doubleword address of the start of the 

channel program command list specified by the 
M:EXCPcall. 

The end-action routine may obtain the complete TDV status 
by referencing the doubleword table DCT 13 using the DCT 
index in register 7. 

CALL NEWQ 

MlNEWQ The M-.NEWQ procedure requests I/O to be 

performed without a DCB and without a user-built channel 
program. The format of the procedure call is 



MrNEWQ [{n W }1 (FC, [*]code), 



L (BUF/ (BA(loc)J )/(SIZ#w 



value);- 



f,(DA,*disk address! r . m . -, 

l,(DCT, [*]index) ) [ ' (PRI ' Np" "^ 



-[,(NRT, [*Jvalu e2 )],[,(EA, [*]loc 2 [, [*]eai])] 



there 



W/NW is the WAIT/NO-WAIT option. The un- 
mapped user always does I/O with NO-WAIT. This 
implies that the unmapped user should always (ex- 
cept for unusual cases) specify an end-action ad- 
dress in order to ascertain when the I/O has com- 
pleted. The mapped user will do I/O with WAIT 
unless otherwise specified by the procedure call. 
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FC, [*]code is the function code which defines (to 
the device handler) the type of I/O operation to 
be performed. See discussion of function codes 
below. 



BUF / BA(loc) specifies the byte address of the 
user's buffer to be used in this I/O operation. 



; BUF, *loc specifies the word address of a word which 
contains the byte address of the user's buffer. 

SIZ, [*Jvalue is the byte count to be used in this 
I/O operation. (The byte count for mapped pro- 
grams should not exceed 32 K bytes (X'8000')). 

DA, * disk address specifies, for random-access- 
device operations only, the address of the word 
containing the disk address to be used in this I/O 
operation. Disk addresses are of the format de- 
scribed under the discussion of the M:GDG pro- 
cedure call. 

DCT, [*]index specifies for non-random-access- 
device operations only, the DCT index of the 
device to be used in this I/O operation. 

PRI, [*]priority is the priority to be associated with 
the requested I/O operation. See the description 
of priority under the discussion of M:EXCP. 

NRT, [*] value is the number of recovery tries to 
attempt before declaring an error. 

EA, [*]loc is the physical address, or optionally a 
pointer to a location containing the physical 
address, of the user's end-action routine. 

eai is a word of end-action information. See the 
end-action description under the discussion of the 
M.-EXCP procedure call. The only difference is 
that BUF is the byte-address of the user's buffer 
as supplied by the M:NEWQ procedure call. 

To assist the user in determining the correct function codes 
to be used with the M:NEWQ procedure calls, the follow- 
ing is a discussion describing the function codes of the ex- 
isting device handlers in the system. 



Typewriter Handler. The typewriter handler accepts the 
following function codes: 

- read with editing 

1 - write 

2 - write with device name 

3 - read without editing 

4 - read with editing and retry 

5 - write new line character 

6 - write with device name tabbed 



RAD Handler. The RAD handler accepts the following 
function codes: 

- seek-read 

1 - seek-write 

2 - sense 

3 - seek-checkwrite 

4 - seek-write, seek-checkwrite 

Error recovery on the RAD generally amounts to redoing the 
same operation when an error has been detected. One ex- 
ception is when a checkwrite is being performed fora write 
and an error is Indicated. In this case, the write is done 
over, followed by another checkwrite. Checkwrites are 
performed for all writes if sense switch 1 is set on the op- 
erator's console. Special conditions checked for are write 
violation and illegal seek address. 



9-Track Tape Handler. The 9-track tape handler accepts 
the following function codes: 

- read 

1 - write 

2 - read reverse 

3 - write tape mark 

4 - backspace record 

5 - forwardspace record 

6 - backspace file 

7 - forwardspace file 

8 - rewind 

9 - sense 

10 - correctable read recovery 

11 - noncorrectable read recovery 

12 - write recovery 

13 - correctable read reverse recovery 

14 - noncorrectable read reverse recovery 

15 - write tape mark recovery 



7-Track Tape Handler. The 7-track tape handler accepts 
the following function codes: 

- read packed 

1 - write packed 

2 - read reverse packed 

3 - write tape mark 

4 - backspace record 

5 - forwardspace record 

6 - backspace file 

7 - forwardspace file 

8 - rewind 

9 - read binary 

10 - write binary 

11 - read reverse binary 

12 - read decimal 

13 - write decimal 

14 - read reverse decimal 

15 - read packed recovery 

16 - write packed recovery 

17 - write tape mark recovery 

18 - read binary recovery 

19 - write binary recovery 
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20 - read decimal recovery 

21 - write decimal recovery 

22 - final backspace record for reverse read 

23 - final backspace record if unrecoverable error 



Card Reader Handler. The card reader handler accepts 



the following function codes: 

- read binary 
2 - read automatic 



Line Printer Handler. The line printer handler accepts 
the following function codes: 

1 - write without format 
3 - write with format 



Paper Tape Handler (PTAP). The paper tape handler ac- 
cepts the following function codes: 

- read automatic 

1 - write BCD 

2 - read count 

3 - write binary 

4 - read direct 

5 - write direct 

6 - read BCD 

7 - read binary 



Card Punch Handlers. The card punch handlers accept the 
following function codes: 

- punch BCD 

1 - punch binary 



Disk Pack Handler (DPAK). The disk pack handler uses the 
following function codes: 

- seek-read 

1 - seek-write 

2 - sense 

3 - seek-checkwrite 

4 - read 

5 - write 

6 - checkwrite 

7 - restore 

8 - seek-read header 

9 - read header 



CALL QUE 

M'.QUE The M:QUE procedure requests that I/O be 

performed through parameters supplied in a specified DCB. 
At the time of the call, the specified DCB need only be 
9 words in length but must contain valid information in the 
following fields: NRT, QBUF # BLK, and CDA. (See 



Appendix A of the CP-V/BP Reference Manual, 90 17 64. ) 
The format of the M:QUE procedure call is 

M:QUE [*]dcb, (FC, [*]code)[,(EA, [*]loc[, [*]eai])] 

where 

deb specifies the DCB associated with the re- 
quested I/O operation. 

code is an 8-bit code (described in Figure 17 be- 
low) which defines (to the device handler) the 
type of I/O operation to be performed. The code 
may be expressed as a decimal number or as a 
hexadecimal number in the format X'dd'. 

loc and eai function exactly as described under 
the discussion of the M:EXCP procedure call. 
The user's end-action routine (if specified) will 
be entered unmapped via a BAL on register 1 1 
after the TYC (type of completion code) and ARS 
(actual record size) have been entered into the 
DCB. The following information is passed to the 
end-action routine. 



Register 

6 

7 

8 

14 

where 



Bit Fields 

15,17 
24,8 
8,7,17 
32 



Contents 

-,BUF 
-,DCT 
FC, -, DCB 
EAI 



BUF is the word address of the user's buf- 

fer associated with this I/O request 

DCT is the DCT index as specified in the 
CDA field of the DCB at the time of the 
M:QUE procedure call. 

FC, DCB, and EAI are as specified in the 
M:QUE procedure call. 

For the unmapped user, the I/O will be queued at a priority 
of X'FF'. For the mapped user, the I/O will be queued 
based upon the user's current execution priority. 





1 2 3,4 


7 









DIR 


PACK 


FBCD 


Code 




V 


/here 






Code has the following meanings: 




- read BCD 




1 - read direct BCD 




2 - read binary 





Figure 17. I/O Operation Codes for Device 
Handler (M:QUE) 
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3 


- read direct binary 


4 


- write BCD 


5 


- write direct BCD 


6 


- write binary (write and format) 


7 


- write direct binary 


A 


- skip record forward 




B 


- skip record reverse 




C 
D 
E 


- skip file forward 

- skip file reverse 

- rewind 


bits 1-3 are 
ignored for 
these codes 


F 


- write end-of-file 




FBCD specifies no FORTRAN conversions 
if or FORTRAN conversions if 1. 


DIR specifies forward direction if or re- 
verse direction if 1. 


If the device is not 9T, 7T, or MT, only bits 5 
through 7 are meaningful. 



Figure 17. I/O Operation Codes for Device 
Handler (M:QUE) (cont.) 



SEND CHARACTER TO TERMINAL 

M:C0C The M:COC procedure sends a character to a 

user terminal. 



f(UN, [*]user#)l . V character' 1 

M:COC l(LN, [*]line#)l' (CHAR 'l*loc[ # ireg]} ] 



where 



user* is the user number of the user whose terminal 
is to receive the character. 



me 



# 



is the line number of the terminal which is 



to receive the character. 



'character' is the EBCDIC character to be sent to 
the specified terminal. 

*loc[, ireg] specifies the address of a location 
which contains the character to be sent to the 
terminal (loc). (The asterisk is required but does 
not indicate indirectness.) The ireg field specifies 
an index register which contains the byte displace- 
ment which, when added to the address specified 
by loc, will yield the byte address of the char- 
acter to be sent to the terminal. If ireg is absent, 
loc is assumed to contain the left-justified char- 
acter to be sent to the terminal. 



DYNAMIC PHYSICAL PAGE ALLOCATION 
FOR REAL-TIME PROCESSING 

INTRODUCTION 

Physical pages are made available for real-time processing 
in either of two ways: 

• Dedication of physical core pages at boot-time. These 
pages are known as the Resident Foreground (RESDF) 
pages. SYSGEN parameters define the physical pages 
that are to be removed from the system and dedicated 
to real-time processing. These pages remain dedi- 
cated real-time pages until returned to the system via 
the Physical Page Stealer (PPS) Ghost. 

• Dynamic acquisition and release of physical core pages 
during normal operations. These pages are known as 
the Dynamic Resident Foreground (DYN RESDF) pages. 
The operator can acquire or release DYN RESDF pages 
by communicating with the Physical Page Stealer (PPS) 
ghost job. 

In both cases, foreground memory is allocated in 'memory 
segments'. A memory segment in this context is simply a 
set of contiguous physical pages. There is only one RESDF 
memory segment (i.e., that which may be allocated at 
boot-time). There may be several DYNRESDF memory 
segments, the maximum number of which is specified at 
SYSGEN time. All real-time memory segments must be 
allocated in the area between 64K and the end of physical 
core. 

The operator, by communicating with the Physical Page 
Stealer ghost job, has control over the allocation of both 
RESDF and DYNRESDF pages. The operator also has the 
ability to reset the SYSGEN defined RESDF size and maxi- 
mum DYNRESDF size thus affecting the system's maximum 
user size. Increases to RESDF size or to maximum DYN- 
RESDF size cause a decrease of the maximum user size; 
decreases to RESDF size or the DYNRESDF size cause the 
maximum user size to be increased. By setting the maxi- 
mum number of real-time pages that may be allocated to a 
minimum, the operator is able to allow very large jobs to 
be scheduled. Decreases to the maximum real-time page 
values may be effected at any time. Increases that would 
cause the maximum user size to be set to less than 186 pages 
are limited to times when there are no users on the system 
other than system ghosts; i.e., the system must be quiescent 
except for ALLOC AT, RBBAT, FILL and the PPS ghosts. 
Neither RESDF nor DYNRESDF maximum size may be in- 
creased to the point where the maximum user size is too small 
to allow the system ghosts to run. 



SYSGEN CONSIDERATIONS 

The system parameters that define the pages to be allo- 
cated at boot-time, the maximum number of pages that may 
be dedicated for real-time use, and the maximum number 
of memory segments that may be allocated for real-time 
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processing may be specified via options, of the :FRGD 
command of PASS2. The format of these options is as 
fol lows: 

(RESDF, size, address) 

where 

size specifies, in decimal, number of pages, the 
default size of the dedicated foreground memory 
area to be allocated at system initialization. 

address specifies, in hexadecimal, the word ad- 
dress of the first page in the RESDF memory seg- 
ment. This value must be equal to or greater 
than 10,000]6. 

Both size and address may be overridden by the operator at 
system initialization. Both parameters may be reset via 
communication with the Physical Page Stealer ghost job. 

(DYNRESDF, pages, segments) 
where 

pages specifies in decimal the maximum number of 
pages that may be dynamically allocated for fore- 
ground use. These pages are not removed from 
the system until requested, but the maximum user 
size is reduced by the value specified. This value 
may be altered by the operator via the PPS ghost. 

segments specifies in decimal the maximum number 
of dedicated real-time memory segments that may 
be allocated for foreground use. The default 
value is one. 



Either value may be omitted, or a response of NEW LINE 
alone may be used to request the SYSGEN-defined default 
for the omitted value(s). 



THE PHYSICAL PAGE STEALER GHOST JOB (PPS) 

The Physical Page Stealer ghost job is used for the manage- 
ment of all dedicated foreground memory. It is loaded for 
execution via the following keyin: 

IGJOB PPS 

PPS then asks the operator for a command: 



PPS: ENTER COMMAND 



The operator may respond with one of the fol lowing commands: 

Dl[SPLAYj Display memory segments currently 
allocated. 

GE[T] yyy,xxxxx Get DYNRESDF pages. 

FR[EE] yyy,xxxxx Free DYNRESDF pages. 

DY[NRESDF] yyy Reset maximum number of DYN- 
RESDF pages. 

RE[SDF] [yyy][, xxxxx] Redefine the RESDF area. 

EN[D] Exit ghost job. 



INITIALIZATION 

When a real-time system is booted from a system tape and 
operator console interaction is requested, or when a real- 
time system is booted from the system RAD, the following 
message is output on the OC device: 



RESET RESDF YYY, XXXXX? 



This allows the operator to override the SYSGEN-defined 
values for the beginning of the RESDF area and/or the size 
of the RESDF area. The operator should respond as follows: 

[yyy] [, xxxxx]© 

where 

yyy is the number of pages in decimal to be in the 
RESDF area. A value of through 999 may be 
used. 

xxxxx is the word address in hexadecimal of the 
first page in the RESDF area. A value greater 
than 10,000 ]6 (64K) must be used. 



where 

yyy specifies in decimal the number of pages. 

xxxxx specifies the word address in hexadecimal 
of the first page in the real-time memory seg- 
ment. This value must be equal to or greater 
than 10,000 lo . 

PPS will attempt to perform the requested function, type 
an error message if the function cannot be performed, and 
reprompt the operator to get the next command. The END 
command is used to terminate PPS processing. 

If the format of the command is in error, such as missing 
parameters, bad delimiters, etc., PPS will type '??' and 
reprompt the operator to reenter the command. 

The following message will be displayed if the number of 
pages specified is in error: 



EXPRESS * OF PAGES IN DECIMAL 0-999 
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The fol lowing message wil I be displayed if the page address 
specified is in error: 



EXPRESS PG ADDR IN HEX 10,000-xxxxx 



where xxxxx is the word address of the last page of physi- 
cal core. 

Since the operator is the only one who is allowed to com- 
municate with the PPS ghost, running PPS is not allowed 
from on-line or batch. If attempting to run PPS other than 
as a ghost job, the following message will be typed: 



MUST BE EXECUTED AS A GHOST JOB 



The PPS commands are described in detail in the following 
paragraphs. 



DISPLAY The DISPLAY command is used to obtain 

information concerning allocated real-time pages and the 
current settings of system parameters that define the maxi- 
mum real-time pages allocation. 

The following information is output on the OC device: 

MAX DYNRESDF = yyy 
CURRENT DYNRESDF = yyy 
DYNRESDF SEGMENT yyy xxxxx 
RESDF SEGMENT yyy xxxxx 
MAXIMUM USER CORE = yyy 

where 

yyy is the decimal number of pages. 

xxxxx is the hexadecimal word address of the first 
page in the real-time memory segment. 

The DYNRESDF SEGMENT message is repeated for each 
currently allocated DYNRESDF memory segment. 

GET The GET command is used to allocate DYNRESDF 

pages. This command may be used at any time and has no 
effect on the maximum user size. The format of the 
command is 

GE[T] yyy, xxxxx 
where 

yyy specifies in decimal the number of pages. 

xxxxx specifies the word address in hexadeci- 
mal of the first page in the real-time memory 
segment. This value must be equal to or greater 
than 10,000.,. 



The PPS ghost first validates that it is valid to allocate 
DYNRESDF pages. If the maximum number of DYNRESDF 
segments has already been allocated, the following mes- 
sage is displayed: 



MAXIMUM DYNRESDF SEGMENTS ALLOCATED 



If the allocation of the DYNRESDF memory segment would 
cause the number of DYNRESDF pages to exceed the maxi- 
mum allowed, the following message is displayed: 



EXCEEDS DYNRESDF 



The PPS ghost then validates that the pages specified are 
available. If the pages are currently being used by the 
monitor, (i.e., for transaction processing), the following 
message is typed: 



PAGES IN USE BY MONITOR 



If some or all of the pages specified are allocated as RESDF 
or DYNRESDF pages, the following message is typed: 



PAGES ARE REAL TIME PAGES 



The DISPLAY command should be used to determine the 
current allocation of real-time memory segments. 

If the pages cannot be obtained for any other reason, the 
following message is typed: 



UNABLE TO OBTAIN PAGES 



Otherwise, the pages specified are removed from the system 
and the operator is prompted to enter the next command. 

FREE The FREE command is used to return currently 
allocated DYNRESDF pages to the system. This command 
may be used at any time and has no effect on the maximum 
user size. 

The format of the command is 
FR[EE] yyy, xxxxx 



where 



yyy specifies the number of pages in decimal. 

xxxxx specifies the word address in hexadecimal of 
thefirst page in the real-time memory segment. This 
value must be equal to or greater than 10,000.,. 
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DYNRESDF memory segments cannot be partially released. 
That is, all pages within the memory segment must be 
released with one FREE command. If the pages specified 
are not totally contained in one memory segment, or the 
entire memory segment was not specified, the following 
message is displayed: 



NOT A DYNRESDF MEMORY SEGMENT 



The display command should be used to determine the 
currently allocated DYNRESDF segments. 

If the segment specified is valid, the pages will be returned 
to the system and the operator will be prompted to enter 
the next command. 



DYNRESDF The DYNRESDF command is used to re- 

define the maximum number of pages that may be removed 
from the system to be used as dynamic RESDF pages. No 
pages are obtained or released as a result of this command. 
This command alters the maximum user size. 

The format of the command is 
DY[NRESDF] yyy 

where yyy specifies the number of pages in decimal. 

The value specified is compared to the current setting of 
maximum number of DYNRESDF pages. If attempting to 
increase the maximum size, the system must have no users 
other than system ghosts. If other users are on the system, 
the following message is typed: 



SYSTEM ACTIVE 



The maximum user size will be decreased by an amount 
equal to the increase in maximum DYNRESDF pages. PPS 
checks to determine that the system ghosts would be able 
to tolerate the decrease in user size. If not, the following 
message is displayed: 



DON'T LOCK OUT SYSTEM GHOSTS 



Otherwise, the maximum number of DYNRESDF pages that 
may be allocated is reset as specified and the maximum 
user size is decreased by the amount of increase to maxi- 
mum DYNRESDF pages. 

If attempting to decrease the maximum number of DYNRESDF 
pages and the maximum user size wouldfall below 186 pages, 
the value specified must be equal to or greater than the 
number of DYNRESDF pages currently allocated. If not, 
the following message is displayed: 



Otherwise, the maximum number of DYNRESDF pages that 
may be allocated is reset as specified and the maximum 
user size is increased by the amount of decrease to maxi- 
mum DYNRESDF pages. 



RESDF The RESDF command is used to redefine the 

RESDF memory segment. The RESDF command may be used 
to release all RESDF pages to the system or to obtain RESDF 
pages. 

The format of the command is 
RE[SDF][yyy][,xxxxx] 

where 

yyy specifies the number of pages in decimal. 

xxxxx specifies the word address in hexadecimal 
of the first page in the real-time memory seg- 
ment. This value must be equal to or greater 

than 10000,,. 
lo 

To release all RESDF pages, the following format should be 
used: 

RESDF 

This will cause all RESDF pages to be returned to the sys- 
tem. The maximum user size will be increased by the 
RESDF size. 

If the RESDF memory segment is not currently allocated 
when this format of the RESDF command is used, the fol- 
lowing message is displayed: 



NO RESDF PAGES ALLOCATED 



To re-establish the RESDF memory segment, the following 
format of the command should be used: 

RE S D F [ y y y] l# xxxxx] 

If either the number of pages or the word address of the 
first pageisnot specified, the previous value of the param- 
eter is used. 

If the RESDF segment is currently allocated, the following 
message is typed: 



RESDF PAGES ALREADY ALLOCATED 



CURRENT DYNRESDF PAGES > NEW MAXIMUM 



When this format of the RESDF command is used, the max- 
imum user size will be decreased by an amount equal to 
the size of the RESDF segment to be allocated. There- 
fore, if the maximum user size would fall below 186 pages, 
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there must be no users on the system other than system 
ghosts and the system ghosts must be able to tolerate the 
decreased user size. Checks are also made to determine 
if the pages specified are available as described under the 
discussion of the GET command. 

Otherwise, the pages specified are removed from the 
system and the maximum user size is decreased by an 
amount equal to the number of pages in the RESDF memory 
segment. 



END The END command terminates PPS processing and 

has the format 



enLd] 



MONITOR DEFs 

The following words are DEFed in the monitor root and may 
be used by the real-time programmer to gain information 
concerning the current allocation of real-time pages. 

RESDF The size of the RESDF area currently 

allocated. If all RESDF pages have 
been returned to the system, the 
value is zero. 

RESDFP The word address of the first page in 

the RESDF area. 

DYNRESDF The number of DYNRESDF pages 

currently allocated. 

MDYNRESDF The maximum number of DYNRESDF 
pages that may be allocated. 

PPrUPPC The total number of RESDF and 

DYNRESDF pagescurrentlyallocated. 



i RESDF MEMORY CAL 

The real-time user may obtain information from the monitor 
concerning the current allocation of real-time memory 
segments by issuing the following CAL: 

CAL 1,5 fpt 

where fpt points to word of the FPT shown below. 

word 



X'lB' 



Word address of first page 



TS i 2 3 I 4 5 6 7 I 8 9 10 11 1 12 13 14 15 1 16 17 18 191m 21 22 23 1 24 25 26 27 1 28 29 30 31 



word 1 



Number -of pages 



1 2 3 14 5 6 7 18 9 10 11112 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 

The system checks to see if the set of pages specified in the 
FPT are currently allocated real-time pages. On return 
from the CAL, the condition code setting will be as follows: 



12 3 4 




The pages specified are the RESDF 
segment. 



1 The pages specified are a DYNRESDF 

segment. 

10 All pages are currently allocated 

real-time pages but are not a speci- 
fic memory segment. 

10 Some, but not all of the pages are 

currently allocated real-time pages. 

10 None of the pages are currently 

allocated real-time pages. 
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10. TRANSACTION PROCESSING FACILITIES 



This chapter describes a program called the System Queue 
Manager and a procedure that was designed for use by 
Xerox in the development of the transaction processing 
facilities of CP-V. The procedure should never be included 
in any user-written programs. This chapter is intended for 
Xerox system programmers only. 



SYSTEM QUEUE MANAGER 

The System Queue Manager is a program that is part of the 
CP-V monitor. It is essentially a message switching system 
developed for transaction processing in CP-V. The Queue 
is maintained in core and overflows onto a disk file. This 
file is created, opened, closed and otherwise maintained by 
a privileged (CO or higher) program defined as the Queue 
owner. The Queue owner unlocks the Quejs by executing 
the UNLOCK queue call and passing the ac' --ess of the 
Queue DCB to the Queue Manager. The Queue DCB must 
be open and must define a random file for the Queue. 
Once the Queue owner has been established and the Queue 
unlocked, only that task may LOCK the Queue and close 
the Queue file. The Queue file must remain open through- 
out the entire UN LOCK-LOCK session. 

Following the UNLOCK, the Queue owner stores the start- 
ing TID (transaction ID) into the Queue Manager's TTP table 
and Queue processing may begin. 

Programs with TP authorization may now process messages 
through the System Queue Manager. Each message has the 
format of a Formal Queue Message (see the GET message 
for this format). The entry name is defined as: 

fi rst-name -segment. [. . . nth-name -segment.]TID 

Each name segment is separated by a period (. ). The final 
name segment is always the unique TID (in EBCDIC). See 
the M:GETID procedure which describes how these unique 
TID's are obtained. For TP, the first-name-segment con- 
sists of the identifier (? @ "J followed by the trancode or 
reportcode. The maximum length of the entry name is 
31 bytes. The first-name-segment length may be no larger 
than the KEYMAX specification on the UNLOCK request. 
The maximum length of the entry text is 1980 bytes. 

To GET messages from the Queue, the DEFINELIST request 
is issued to describe the criteria of the entries desired 
by this program. A criterion is defined as: 

first-name -segment. [. . . nth-name -segment] 

Each criterion must have at least one period (i.e., define 
at least the first-name-segment). The criterion is followed 
by a flag byte which tells the Queue Manager whether 
'failed' entries are acceptable or whether 'destructive 
readout' is in force. If destructive readout is requested, 
the Queue message is deleted from the Queue when it is 



moved to the user's buffer. Otherwise the Queue message 
is marked in-progress in the Queue and remains in -progress 
until its status is changed (to not-in -progress or failed) or 
it is deleted \f\a a PUT request. 

The DEFINELIST request is followed by a GET request for 
that list (the LIST ID specified with the GET is returned from 
the DEFINELIST call). Once the GET has been issued the 
associated criteria become 'active'. This means that each 
time an entry is inserted in the Queue, the criteria will be 
compared to that entry and if a match is found, the ECB 
associated with the GET request will be posted with the 
X'02' completion code. When the ECB is posted, the GET 
request may be reissued to obtain the Queue message. Note 
that there is no guarantee that a reissuance of the request 
will actually get a Queue message, since another program 
may have gotten it or altered its status since the ECB posting; 
therefore the resulting condition codes may still indicate 
that the ECB wait is meaningful. When the condition codes 
are returned as zero, the Queue message has been placed 
in the specified buffer and SRI is set with the offset into the 
criteria list pointers describing which entry was obtained. 
An example of a typical GET routine is: 



GETMSG 


M:QUEUE 


*LISTID,GET,(BUF,*ADDR , > ; 
, (BSIZE ,512) , (ECB .GETECB) 




BCR,12 


GOTMSG 




BCS,8 


ERRORCHK ABNORMAL IN SR3 




M-.CHECKECB 


(ECB, GETECB) 


, 


BNEZ 


ERRORECB 




B 


GETMSG 


GOTMSG 


EQU 


$ 



* AT THIS POINT MSG HAS BEEN RECEIVED 

A program does not wait until a Queue message arrives which 
satisfies its active criteria. The WAIT option only waits to 
give the caller access to the Queue. If no ECB is specified 
on a GET request, the caller will get a Queue message if 
one is currently queued or will be given a BC-14 abnormal 
(return condition codes = 8) if a match is not currently in 
the Queue. 

The PUT request is used to insert a Queue message into the 
Queue, to alter the status of an existing in-progress entry, 
or to delete an in-progress entry from the Queue. Each 
entry in the 'put list 1 points to a specific Queue message 
and the flag byte in the list indicates what action is to be 
taken for that Queue message. For a PUT request, each 
item in the list is processed before return is made to the 
calling program. 

The PURGE request is issued to delete a currently defined 
get list (a previous DEFINELIST). When the criteria is no 
longer valid or useful, the PURGE should be requested to 
free up the list and criteria pages and the Queue Manager 
work space. 

The STATS request returns the status of a Queue message 
(i.e., Queued, Failed, In-progress, etc. ) and optionally the 



148 Transaction Processing Facilities 



count of entries queued which match the first -name -segment 
of the specified criterion. The STATS list is always one 
item long. If no list is specified (list loc is 0), the STATS 
request returns the current status of Queue itself (i.e., 
number of entries queued, number of entries in-progress, 
number of entries failed, etc. ). 

The LOCK request ends Queue processing. All subsequent 
requests will be given the BC-11 (Queue Locked) abnormal 
code. The LOCK request must be issued by the same user 
(i.e. , user number) which issued the UNLOCK request, 
since that user has been defined as the Queue owner. The 
LOCK causes the in-core queue pages to be flushed out to 
the Queue file and returns the in-core pages to the system. 



The format of the M:QUEUE procedure is 



M-.GETID PROCEDURE FORMAT 

Each Queue message that is placed in the System Queue 
must have a unique identifier appended to the entry name. 
This identifier is obtained from the Queue Manager by 
issuing an MrGETID call. The TID is returned in hexa- 
decimal in register SRI. It must be converted to eight 
EBCDIC characters and appended to the entry name. The 
TID is always the final -name -segment of a queue entry 
name and is separated from the other name segments with 
the period (.) delimiter. The format of the procedure 
call is 

M:GETID 

Calls generated by the M:GETID procedure have the form 
CAL1, 7 fpt 

where fpt points to the FPT shown below. 



X'OD' 



1 2 3 1 4 5 6 7 Is 9 10 111 12 13 M lj! 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 » 30 31 

If the queue is locked when the call is issued, no TID 
is placed in SRI and return is made to CAL+1 with CC1 
set. 



| MflUHJE PROCEDURE FORMAT 

In transaction processing, the flow of transactions and re- 
ports is controlled through a single queue by the System 
Queue Manager. The M:QUEUE procedure was developed 
for use in the System Queue Manager and requires trans- 
action processing authorization (via the Super processor). 



M:QUEUE 



[* deb address 
[*]list loc 
[*]list id 



f UNLOCK 
DEFINELIST 
PUT 
GET 
STATS 
PURGE 
LOCK 



[,(option)]. . . 



where 



deb address specifies the address of the DCB for 
UNLOCK and LOCK requests. 

list loc specifies the location of the list of criteria 
pointersfor PUT, DEFINELIST, and STATS requests. 

list id specifies the id of a list for GET and PURGE 
requests. 

UNLOCK activates usage of the queue and de- 
fines the queue owner. 

DEFINELIST defines the criteria for subsequent 
GET requests (i.e., the GET lists). 

PUT enters a transaction or report into the queue. 

GET retrieves a transaction or report from the 
queue. 

STATS returns the status of a transaction or report. 

PURGE discards outstanding GET lists which are 
active for a given user and releases user-associated 
queue control tables. 

LOCK ensures that the user is the queue owner and 
locks the queue from further use. 

The basic options are as follows: 

LSIZE, [*] value specifies the size of the list for 
PUT or DEFINELIST. 

BUF, [^Jaddress specifies the buffer address for re- 
turning a queue entry for a GET request or for return- 
ing queue status information for a STATS request. 

BSIZE, [*J value specifies the size (in words) of the 
area defined by the BUF option. 

WAIT specifies that the caller wishes to wait for 
access to the queue prior to resuming execution. 

ECB, L*J address specifies the address of an ECB to 
be posted when a queue event occurs. A queue 
event may be: the arrival of an entry to the queue 
which satisfies an active GET list; the availability 
I of the queue (when the WAIT option was not indi- 

cated on the original queue request); or queue 
space availability. 
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The following option is applicable only to the GET request: 

INDEX, [*]value specifies the word displacement 
within the GET list to start the search for a criteria 
match. 

The following option is applicable only to the PUT request: 

ll nw f specifies the priority for PUT requests. 

The following options are applicable only to the UNLOCK 
request: 

{ k , r ... | specifies whether the queue is a new or 

NEW) . .. r., ^ 

existing file. 

BACKUP specifies that the queue is to be kept up- 
to-date on secondary storage, (i.e., whenever a 
queue block is modified in core it is to be written 
to disk). 

QPAGES, [*J value specifies the maximum number of 
core pages which can be used for queue blocks and 
queue manager work pages. 

QSAT, L*J value specifies the percentage of queue 
capacity for acceptance of high priority PUTs only. 

KEYMAX/L*] value specifies the maximum number 
of bytes required to contain any name (trancode) 
presented for enqueueing (1-13 may be specified). ; 

RECOVER specifiesqueue unlock for recovery mode. 

The following option is applicable only to the STATS request: 

COUNT specifies that the number of occurrences 
in the queue of a specified criterion is to be re- 
turned in the second halfword of SRI. 

The following option is applicable only to the LOCK request: 

PAUSE specifies that the queue lock is temporary 
and current users may continue processing their 
current outstanding requests when the queue is 
unlocked. 



FPT Code Funct 



ion 



M:QUEUE FUNCTION PARAMETER TABLES (FPTS) 

Calls generated by the M:QUEUE procedure have the form 

CAL1,7 fpt 

where fpt points to word of an FPT. The code in the first 
byte of word is as follows: 

FPT Code Function 



X'06' 
X'07' 



UNLOCK 
DEF1NELIST 



X'08' 


PUT 


X'09' 


GET 


X'OA' 


STATS 


X'OB' 


PURGE 


X'OO 


LOCK 



The various FPT formats are described in the sections that 
follow. 



QUEUE UNLOCK REQUEST 

The format of the FPT for the UNLOCK request is: 
word 



X'06' 



0- 



DCB address 



n 2 3 I 4 5 6 7 18 9 10 11H2 13 14 151)6 17 18 19120 21 22 23124 25 26 27128 29 30 31 



word 1 



1 2 3 14 5 6 7 18 9 10 111 12 13 14 15-T 16 17 18 19F20 21 22 23l24 25 26 27T28 29 30 31 







where 



F = 1 means WAIT option specified. 
F_ = 1 means BACKUP option specified. 

F_ = 1 means NEW option specified. 



F . = 1 means RECOVER specified, 

option ECB (P]) 



ECB address 



01 2 3 14 5 6 7 18 9 10 111 12 13 14 151 16 17 18 19120 21 22 23T24 25 26 27128 29 30 31 



option Q PAGES (P2) 



Number of queue 
core pages 



12 3 14 5 6 7 18 9 10 III 12 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 



option KEYMAX (P3) 



Key size 



01 2 3 I 4 5 6 7 Is 9 10 111 12 13 14 15l 16 17 18 19 1 20 2l 22 23I24 25 26 27I28 29 30 31 

option QSAT (P4) 







1 2 3 14 5 6 718 9 10 11112 13 14 15116 17 18 19120 21 22.23 

QUEUE DEFINELIST REQUEST 

The format of the FPT for DEFINELIST is: 
word 



Saturation % 



24 25 26 27128 29 30 31 



X'07' 

6 "t 2 3 I 4 5 6 7 



List address 



8 9 lb 111 12 13 U 15 1 16 17 id 19l20 21 22 23 1 24 25 26 27I28 29 30 31 
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word 











2 3 1 4 5 6 7 ! 8 9 10 til 12 13 14 isli* i? IB i^t 2ft l\ J? 23I24 25 26 27 

where F, - 1 means WAIT option specified, 
option ECB (Pi) 















ECB address 



1 2 3 I 4 5 6 7 l B 9 10 11 1 12 13 14 \5\ 16 b Ifi 1* 1 20 il 22 2:il 24 is 26 27 f 2fe 29 30 31 

option List Size (P2) 



-0 



0"M 2 3 I 4 5 6 7 I B 9 10 It! 12 13 14 15 



List size 



16 17 18 19l» 21 22 23! 24 25 26 27 1 28 29 30 3l' 



QUEUE PUt REQUEST 



The format of the FPT for PUT is: 
word 



X'08' 



0- 







List address 



1 2 3 I 4 5 6 7 I B 9 10 llll2 13 14 T 15l 16 17 18 19! 20 21 22 23 1 24 25 26 27! 28 29 30 31 

word 1 







~0" 1 2 3T4 5 6 7 I B 9 10 llll2 13 14 I5I 16 17 18 19I 20 21 22 S3 1 24 25 26 27I2B 29 30 31 

where 

Fj = 1 means WAIT option specified. 

F2 ~ means low priority request. 
?2 ~ 1 means high priority request. 

option ECB (P]) 







ECB address 



1 2 3M 5 6 7 IB 9 10 11112 i3 14 15H6 17 IB 19 1 20 21 22 23124 25 26 27128 29 30 31 

option List size (P2) 











r fi 9 10 111 



List size 



1 2 3 I 4 5 6 7 I B 9 10 11112 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 3 



1 20 21 22 23h 



option Index (P2) 



i 2 3 I 4 5 6 7 Is 9 10 Illl2 13 14 15M6 17 18 19 1 20 21 22 23^4 25 26 2/ 1 28 2« 30 



Index 



option Buffer address (P3) 











Buffer address 



1 2 3 I 4 5 6 7 I 8 5 10 llll2 13 14 15ll6 17 IB 19 1 20 21 22 23 f 24 25 ;e 2T 1 28 29 30 31 



°l 


ation Buffer size (P4) 










* 





Buffer size 





1 2 3 14 5 6 7 1 8 9 10 111 12 13 14 15 


16 17 18 19 1 20 21 22 23^4 2=. 26 , 


- 1 2B 2V >1 3' 



QUEUE STATS REQUEST 

The format of the FPT for STATS is: 
word 



X'OA' 



0- 



List address 



01 2 314 5 6 7 I 8 9 10 11112 13 14 15(16 17 18 19J20 21 22 23124 25 26 27128 29 30 31 

word 1 







12 3 14 5 6 7 I 8 9 10 11 1 12 13 14 15 1 16 17 18 19»f 20 21 22 23 1 24 25 26 27)28 29 30 31 

where 

F2 = 1 means COUNT option specified. 
Fj = 1 means WAIT option specified. 

option ECB (Pi) 



ECB address 



1 2 3 I 4 5 6 7 I 8 9 10 11 1 12 13 14 15l 16 17 18 19l 20 21 22 23l 24 25 26 27 1 26 29 30 31 



option BUF (Pft 



I I 4 5 6 7 I 



Buffer address 



I 16 17 18 19l20 21 22 23l24 25 26 27! 2 



0I23T456 7I89 10 111 12 13 14 T5TI6 17 18 19T20 21 22 23124 25 26 27T28 29 30 31 



option BSIZE (P4) 







1 } ih ; 6 Hi 1 1 i l l 12 is u ij 



Buffer size 

16 I ? 1 8 tt l ^O i\ » U \ U » 26 27 1 36 29 36 3 



QUEUE GET REQUEST 

The format of the FPT for GET is: 
word 



X'09' 







List id 



012314567189 10 UTT2 13 14 151 16 17 IB 191 20 21 2? 23124 25 26 27128 29 30 3: 

word 1 















11} IN 5 6 - l8 9 Ifl II I I2 13 li I5 l t6 '7 1 9 19 1 20 2> ' » ' 23" t » tt ' ib 27T?6 29 3» 3l 

where Fj - 1 means WAIT option specified, 
option ECB (P]) 











ECB address 



0"H 5 Th 5 6 7~\~i 9 10 1lll2 13 14 15I16 17 IB 19! 20' 21 22 23124 25 26 27 1 28 29 30 3' 



QUEUE PURGE REQUEST 

The format of the FPT for PURGE is: 
word 



* 


X'OB' 


c 


List id 


12 3 14 5 6 7 

word 1 


B 9 10 111 12 13 14 15 16 17 18 19120 21 22 23124 25 26 27128 29 30 31 


p 
1 


n <■» 


F 
1 





U 


u 





1 2 3 U 5 6 7 1 


8 9 10 111 12 13 14 15 


16 17 18 19120 21 22 23124 25 26 


27 


28 29 30 31 



where Fj = 1 means WAIT option specified. 
option ECB (P^ 







ECB address 



01 2 TIT 5 6 7 I 8 9 10 111 12 13 14 15 1 16 17 IB 1*1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 
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QUEUE LOCK REQUEST 

The format of the FPT for LOCK is 
word 



X'OO 



-0 



DCB address 



i 2 314 5 6 718 •> ir, >Mli I; .4 Ill6 17 18 |9l?C 21 22 2312425 26 27128 29 30 31 

word 1 



I 2 3M 5 4 7(8 » tf Ul 12 U 14 151 14 17 18 19I2C 21 27 23 



o—o 



— 



24 25 26 27128 2* 30 31 



where 

Fi 1 means WAIT option specified. 

F5 - 1 means PAUSE option specified, 

option ECB (Pi) 







■0 



ECB address 



I 2 Ttl 5 6 r t"a 5 if: Itfl? 13 14 <5 ! 16 17 18 I9I2O 21 22 23 1 24 25 2ft 27J28 ?9 30 31 



LIST FORMATS 

DEFIMELIST OR STATS LIST 

The format of the DEFINELIST or STATS list is : 



Name] length 



Virtual byte address of criterion l 



i 2 ft"* 5~ 6 TT8 9 10 111 12 13 4 15 1 16 17 18 ivl 20 21 22 23 1 24 25 24 27 1 28 29 30 31 



Name n length 



Virtual byte address of criterion 



i 2 3 I 4 5 6 7 * 8 9 10 III 12 13 4 15 1 16 17 IB 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



The criterion is in TEXT format name-segments followed by 
a flag byte. At least one period must appear in the criterion 
name. 



The flag byte has the format 



1 2 "ti St 7 



where 



F is set to one if failed entries are acceptable 
(i.e., the system is to GET the transaction re- 
gardless of whether or not it was successful). 

D is set to one if the entry is to be destroyed after 

it has been read. 
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GET MESSAGE 

The format of the GET message is: 
word 



5 
6 

14 



JI 



12 3 4 7 8 



Length of record (bytes) 



(Unused by the queue manager) 



Length of entry text (bytes) 



Length of entry 
name (bytes) 



Entry name 



Entry text 



where 

Q indicates queued and is always set to one. 

F indicates failed, if set to one. 

JI are journalization indicators. Although these 
bits are kept in this status byte, the queue man- 
ager does not use this information. The informa- 
tion is stored here for use by other transaction 
processors. 

PUT LIST 

The format of the PUT list is: 



Flags 



Virtual word address of entry j 



i"i 8 ah s 6 r ' i 9 1a ul» la u u l u i? is \t \ » i\ a a\u a a » t a » »i\ 



Flags 

b 1 i i \ i ! I 7 



Virtual word address of entry2 

8 9 to h i 12 13 U 15 1 16 17 it tf t tt 21 22 fal?4 25 U 27 I 28 M 30 31 * 



where the entries are in journal record format. (See the 
GET message, above, for this format. ) 

The first four bits of the flags field have the following 
meaning: 

2 Z. I 1 

0-1 Delete in-progress entry. 

1 Insert an entry into the queue. 

10 11 Mark an entry failed. 

1 1 Put an in-progress entry back into the 
queue. 

1 1 Insert a pre-failed entry into the queue. 

V 



The JI field contains journalization indicators. Although 
these bits are kept in this status byte, the queue manager 
does not use this information. The information is stored here 
for use by the transaction processors. 



MrQUEUE PROCEDURE ttUTPUT PARAMETERS 

SRI INFORMATION 

UNLOCK: Transaction id returned in SRI 



8-character hexadecimal transaction id 



"5 i 2 3 I 4 S 6 7 Is 9 10 111 12 13 14 15 1 16 17 IB 19 1 20 21 22 23I 24 25 26 27 1 28 29 30 31 

DEFINELIST: List-id returned in SRI 



4 digit hexadecimal list id 



1 2 314 5 6 7 18 9 10 11112 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 

GET: Word displacement within the list to the criterion for 
which an entry has been stored in the caller's buffer. 
The format of the entry itself is given in the List For- 
mats section. 

Displacement returned in SRI 



Word displacement 
1 -X'FFFF' 



123I4567T89 10 lTTl2 13 14 15 16 17 18 19120 21 22 23124 25 26 27128 29 30 31 

PUT: Word displacementwithin an erroneous list totheentry 
in error. (The SRI format is the same as for GET.) If 
no errors occur, SRI is meaningless. 

STATS: The status of a queue entry and, optionally, a count 
of such entries are returned in SRI 



Entry count 



1 2 3 I 4 5 6 7 I 8 9 10 11112 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 

where 

Bit = 1 means entry queued. 

Bit 1 = 1 means reserved. 

Bit 2 = 1 means entry in failed status. 

* Bit 3 = 1 means entry in progress, i.e. , given to a 
transaction processor. 

E6B INFORMATION 

ECB completion codes for a queue request are: 

X'01' An entry has been placed in the caller's buf- 
fer. (Posted on a GET request only. ) 

X'02' Normal return. For a GET request, an entry 
is present. Request it again. 

X'OF' Abnormal return. (SR3 contains the abnormal 
code. ) 



CONDITION CODE SETTINGS 

When the M:QUEUE procedure is performed, the following 
condition code settings may result: 

CC1 CC2 Status 

Normal return. 

1 - Queue unavailable or request cannot 

be satisfied. (Abnormal code is 
in SR3. ) 

1 ECB wait is meaningful. 



QUEUE ERROR CODES 

Errors detected by the system Queue Manager result in 
error notification to the caller or a user abort. The error 
code for M:QUEUE CALs is X'BC. The code is communi- 
cated to the caller in SR3 and, if the ECB option is speci- 
fied, in the ECB. The code is contained in byte of SR3, 
a subcode is contained in bits 8-14, and the content of the 
FPT word 0, bits 15-31 is returned in the rightmost 17 bits 
of SR3. Therefore SR3 may contain the deb address, listloc 
or listid depending upon the queue request. The error sub- 
codes are listed in Table 46. 



Table 46. M:QUEUE Error Subcodes 



Subcode 


Meaning 


01 


Illegal queue service requested 




(e.g., an unlock is requested and 




the queue is not locked or the 




caller is not an authorized TP 




user). The task is aborted. 


02 


An event not associated with the 




queue has occurred for the user 




(e.g., M:INT, abort, ESCape or 




BREAK). 


03 


Error return from get physical work 




page (abort during unlock pro- 




cessing only). 


07 


Queue saturated; i.e., index core 




space or queue secondary storage 




space is unavailable. 


08 


Queue lock or unlock caller does 




not have the required privilege. 




The task is aborted. 
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Table 46. MrQUEUE Error Subcodes (cont. ) 



Table 46. M -.QUEUE Error Subcodes (cont. ) 



Subcode 


Meaning 


09 


DCB not open for a lock or unlock 
request. The task is aborted. 


0A 


Space is not available to define a 




list. 


10 


Error in specified address, size, 




or queue message format. 


11 


Queue locked. 


12 


Queue physical page space is not 
available. 


13 


Error in the FPT parameters or the 
specified list. 



Subcode 


Meaning 


14 


Entry not found or a queue request 
requiring an existing entry. 


15 


I/O error during control/index 
transfer for an unlock request. 
The task is aborted. 


16 


I/O error during a data block 
transfer. 


17 


Queue busy. K" "* 


20 


Queue GET or PURGE request for 
a non-existent GET list. 






■*t v 



%S 



1 4 



S,CK>-..,> : .,.W 



^ 



O 



{ 



W"*~ ■£> 



u 
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APPENDIX A. OPERATIONAL LABELS 



Table A- 1. Standard Operational Labels and 
Default Device Assignments 



Table A-2. Batch Assignment of Operational 
Labels 



Opera- 
tional 
Label 


Batch Device 


On-Line 
Device 


Ghost 
Device 


C 


Card reader 


Terminal 


Operator's 
console 


OC 


Operator's 
console 


Terminal 


Operator's 
console 


LO 


Line printer 


Terminal 


Line printer 


LL 


Line printer 


Terminal 


Line printer 


DO 


Line printer 


Terminal 


Line printer 


PO 


Card punch 


None 


Card punch 


BO 


Card punch 


None 


Card punch 


LI 


Card reader 


None 


Operator's 
console 


SI 


Card reader 


Terminal 


Operator's 
console 


BI 


Card reader 


None 


Operator's 
console 


SL 


Line printer 


Terminal 


Line printer 


SO 


Card punch 


None 


Card punch 


CI 


Card reader 


None 


Operator's 
console 


CO 


Card punch 


None 


Card punch 


AL 


Card punch 


None 


Card punch 


EI 


Card reader 


Terminal 


Operator's 
console 


EO 


Card punch 


None 


Card punch 


UC 


Operator's 
console 


Terminal 


Operator's 
console 



Device 


Op label 


Line printer 


LO, LL, DO, SL, LP 


Card reader 


C, LI, SI, BI, CI, EI, CR 


Card punch 


PO, BO, SO, CO, AL, 
EO, CP 


Operator's console 


OC, UC 


9-track magnetic tape 


9T 


7-track magnetic tape 


71 


Default tape 


MT 


None 


NO, ME 



Table A-3. On-Line Assignment of Operational 
Labels 



Device 


Op label 


User's terminal 


C, OC, LO, LL, DO, SI, 




SL, EI, UC, ME, CR 


Card punch 


CP 


Line printer 


LP 


9-track magnetic tape 


9T 


7-track magnetic tape 


7T 


Default tape 


MT 


None 


NO, PO, BO, LI, BI, SO, 




CI, CO, AL, EO, PR, PP 
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APPENDIX B. PHYSICAL DEVICE NAMES 



A physical device name is indicated by yyndd. 

where 

yy specifies the type of device (see Table B-l). 

n specifies the IOP letter for Sigma computers (see 
Table B-2)or cluster/unit for the Xerox 560 (see 
Table B-3). 

dd specifies the device number (see Table B-4), 
in hexadecimal. 



Table B-2. Sigma IOP Designation Codes 



Table B-l. Standard I/O Device Type Codes 


yy 


Device Type 


71 


7-track magnetic tape 


9T 


9-track magnetic tape 


CP 


Card punch 


CR 


Card reader 


TY 


Typewriter 


LP 


Line printer 


DP 


Disk pack 


DC 


Magnetic disk 


ME 


CP-V terminal 


RB 


Remote processing data set 
controller 


XP 


Optical character printer 


MO 


Message mode communica- 
tions equipment 


MC 


Remote assist terminal 



IOP 




Letter (n) 


Unit Address 


A 





B 


1 


C 


2 


D 


3 


E 


4 


F 


5 


G 


6 


H 


7 



Table B-3. Xerox 560 Cluster/Unit Matrix 



Unit 
Number 








Cluster Number 




— — 








1 


2 


3 4 5 


6 


7 


A 


B 


H 


N T Z 


5 


* 


1 


$ 


C 


I 


O U 


6 


* 


2 


# 


D 


J 


P V 1 


7 


* 


3 


@ 


E 


K 


Q W 2 


8 


* 


4 


: 


F 


L 


R X 3 


9 


* 


5 


* 


G 


M 


S Y 4 


L-J 


* 


6 


* 


* 


* 


* * * 


* 


* 


7 


* 


* 


* 


* * * 


* 


* 


* 
Reserved 













(maintenance console) 



Table B-4. 


Device Designation Codes 


Hexadecimal 
Code (dd) 


Device 
Designation 


00 < dd < 7F 
80<dd<FF 


Refers to a device number 
(00 through 7F). 

Refers to a device controller 
number (8 through F followed by 
a device number 9 through F). 
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APPENDIX C. CP-V SOFTWARE CHECK CODES 



Table C-l. CP-V Software Check Codes 



Code: 01 




Called From: 


SCHED, MM 


Message : 


USERS - PAGE CHAIN INCONSISTENT 


Registers: 


When called from SCHED: 




R0 - if circular or unlinked chain; otherwise, the Link number index in chain. 

Rl - Link register. 

R2 - Next page chain link. 

R4 - User being scheduled. 

R7 - Address of Chain Head, Tail, and Count Table. 

SR4 - Offending page number. 




When called from MM (T:XPGVI): 




Rl - Zero. 

R3 - Physical page number. 

R7 - Virtual page number. 


Remarks: 


The requested virtual page in the user virtual map chain (JB.-LMAP) can't be found. See T:PGCHK 
in SCHED. Effective when SSI set. 


Code: 02 




Called From: 


SCHED 


Message: 


REPORTED EVENT INCONSISTENT WITH USER'S CURRENT STATE 


Registers: 


R3 - Previous state. 

R4 - User number (T:RE, T:RCE). 

R5 - User number (T:RUE). 

R6 - Event number. 

R7 - Line number (T:RCE). 

SR4 - Return address for reschedule. 


Remarks: 


The contents of R3 through R7are dependent upon the called entry point. If R4 = S:CU, the call 
was T:RE. If R7 is the line number of the user in R4, the call was T-.RCE. If R4 = R5, the entry 
is T:RUE. 


Code: 0A 




Called From: 


DPSIO, TSIO 


Message: 


OPCODE IN SWAP COMMAND CHAIN IS INVALID 


Registers: 


Case 1, command list security checks— SS4 set: 




Rl - Incorrect command list order code if not equal to R3. 

R2 - Incorrect command list entry address (IOCD). 

R3 - Order code of first IOCD in command list. 

R4 - Swap device index. 

R6 - Command list beginning address. 

R7 - Swapper function code. 
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Table C-l. CP-V Software Check Cedes (cont. ) 





Case 2, Unrecoverable read error during inswap: 








Rl - Inswap user number. 
R7 - DCT index. 








SRI - Incorrect command list entry address (IOCD). 
Dl - Order code. 






Code: OB 








Called From: 


DPSIO, TSIO 






Message : 


INCORRECT ORDER CODE IN SWAP COMMAND LIST 






Registers: 


Rl - Incorrect order code; not seek. 
R2-R7 - See case 1 of screech code OA above. 






Remarks: 


SS4 must be on for check. 






Code: OC 








Called From: 


DPSIO, TSIO 






Message: 


ATTEMPT TO SWAP MONITOR'S MEMORY 






Registers: 


Rl Buffer address. 

R2-R7 - See case 1 of screech code OA above. 






Remarks: 


SS4 must be on for check. 






Code: OD 








Called From: 


TSIO 






Message: 


HALT FLAGS MISSING IN SWAP COMMAND LIST 






Registers: 


RO FLAGS byte from TIC command. 

Rl TIC order code. 

R2-R7 - See case 1 of screech code OA above. 






Remarks: 


SS4 must be set to check. FLAGS must not have command chaining 
zero-byte -counter or channel -end set. 


set and 


must have interrupt-on- 


Code: OE 








Called From: 


TSIO 






Message: 


I/O REQUEST WITH NULL COMMAND LIST 






Registers: 


R4 - Swap device index. 

R6 - Command list beginning address. 

R7 - Swapper function code. 






Remarks: 


Not checked for pack-only swappers. 
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Table C-l. CP-V Software Check Codes (cont. ) 



Code: OF 




Called From: 


DPSIO, TSIO 


Message : 


INPUT FUNCTION CODE IS INVALID 


Registers: 


R2 - Swapper function code. 
D4 - X'OF'. 


Remarks: 


SS4 must be on to check. Function code not between one and five exclusively. 


Code: 10 




Called From: 


COC, ECBBLK 


Message: 


BAD COC BUF POOL, OR BAD BUF ADR ON RELEASE REQUEST 


Registers: 


R2 - Logical line number. 

R4 - Buffer address. 

R6 - Return address from buffer return call. 


Remarks: 


I. On a COC buffer release, an invalid relative buffer address was specified (address 15 or 
HRBAM + 15). 




2. On a COC buffer GET or RELEASE, an invalid relative buffer address was found in the free 
pool chain. If the COC module was assembled with the COCGBUG and COCPBUG flags set 
(normally they're not), and sense switch 4 is set, the entire free pool chain is checked on each 
PUT and GET operation. (The R4 and R6 contents listed above are valid only at entry and exit 




times. ) 


Code: 11 




Called From: 


COC 


Message: 


INVALID INTERNAL CONTROL CODE TRANSLATE REQUEST 


Registers: 


Rl - DCB address. 

R2 - Line number. 

R5 - Character. 

R7 - Byte address of user buffer. 

SR2 - Return address. 

SR3 - Output translation table address. 


Remarks: 


The cause is a translate table error (e.g., 2741 N/L on non-2741 line), or a bad input buffer chain. 
Rl, R7, and SR4 are not always set. 


Code: 12 




Called From: 


COC 


Message : 


COC - BAD INPUT BUF LINKAGE ON RELEASE REQUEST 


Registers: 


RO - Removal point. 

Rl - DCB address. 

R2 - Line number. 

R3 - COC number. 

R4 - Current release point. 

SR3 - Output translate table address. 
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Table C-l. CP-V Software Check Codes (cont.) 





SR4 - Caller's return; RTN + 1 = activation. 
D3 - Return address. 




Remarks: 


The COC input buffers are being released, and there is a conflict 
points and the chain. RO, Rl, R3, and R4 are not always set. 


between the insertion and removal 


Code: 13 






Called From: 


COC 




Message: 


COC -OUTPUT BUF LINKAGE OR CHARACTER COUNT BAD 




Registers: 


Rl - DCB address. 

R2 - Line number. 

R3 - COC number. 

R4 - Removal point (usually negative). 

R5 - Character. 

SR4 - Output count; usually = -1. 




Remarks: 


The output count and buffers are inconsistent. This may be eausec 
clobbered COC tables -usually COCOC, COCOI, or COCOR. 


by extended interrupt pulse or 
Rl is not always set. 


Code: 14 






Called From: 


THEUNCOC 




Message : 


COC ROUTINE CALLED IN N ON -COC SYSTEM 




Registers: 


SR2 - BAL adr if 14-03. 

SR4 - BAL adr if 14-01 or 14-02. 

D4 - BAL adr if 14-04. 




Remarks: 


The subcode indicates which routine was called: 

14-01 COCIO 
14-02 COCOFF 
14-03 COCSENDX 
14-04 ECHOCR2 




Code: 17 






Called From: 


IOQ 




Message : 


INVALID DISK ADDRESS PASSED FOR AN I/O INSTRUCTION 




Registers: 


Rl - IOQ 7, R3 = DCTX = 0. 

R2 - DCB address. 

R3 - Queue index. 

SRI - Seek address from CDA, R2. 

D4 - X'17'. 




Remarks: 


Caused by an invalid DCT index. R2 and SRI are not always set. 
or disk, DSCVT will have been called and R2 and SRI will be set. 


If the invalid address is on a RAD 



160 Appendix C 



Table C-l. CP-V Software Check Codes (cont. ) 



Code: 191 
Called From: 
Message: 
Registers: 



Remarks: 



BUFF 

INVALID BUFFER ADDRESS PASSED FOR RELEASE 

Rl - Index to BUFLIMS. 

R2 - Head of respective buffer pool. 

R5 - JIT address. 

SR4 - Link return address. 

D3 - Buffer address. 

D4 - X'19'. 

Occurs both on releasing and acquiring buffers of most types (CPOOL, SPOOL, and MPOOL), 



Code: 1A 
Called From: 
Message : 
Registers: 

Remarks: 



CLS 



ACCOUNT DIRECTORY INACCESSIBLE 



The account directory is bad and the monitor is unable to reconstruct it. All files are lost. 



Code: IB 
Called From: 
Message: 
Registers: 



Remarks: 



Swapper 

USERS PAGE CHAIN NON ZERO AT SWAP COMPLETION 

Rl - Inswap user number (SrISUN). 

R2 - Physical byte address of JIT. 

R3 - UB:US, 1 (user state). 

R4 - Physical page head. 

R5 - Physical page tail . 

R6 - Physical page count. 

SR4 - Count of swapper free page chain (S:FPPC). 

Swappers' free page pool must be nonzero at end of inswap. S:FPPH, SrFPPT contain head and tai 
of pages just allocated to the inswap user. 



Code: ID 

Called From T:OV 

Message: REQUESTED OVERLAY NUMBER IS OUT OF RANGE 

Registers: R2 - Overlay name. 

R3 - Overlay name. 

R4 - 0. 

D4 - X'lD'. 



Remarks: 



Requested monitor overlay is not in shared processor table, 
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Table C-l. CP-V Software Check Codes (cont. ) 



Code: IF 






Called From: 


SWAPPER 




Message : 


NOT ENOUGH PAGES TO PERFORM THIS SWAP 




Registers: 


R3 - Page to release. 

SRI - Deficient page count. 




Code: 21 






Called From: 


MM 




Message : 


ATTEMPT TO SET ACCESS CONTROLS ON NON-EXISTENT VIRTUAL PAGE 




Registers: 


R6 - Number of pages to set. 
R7 - Virtual page number. 
SR4 - Link register. 




Code: 22 


■ 




Called From: 


PV 




Message: 


PRIVATE VOLUME ALLOCATION ERROR 




Registers: 


R2 - SN count. 

R3 - DCB volume number. 

R4 - SYSID (0 = EXCLusive use). 

R6 - DCB address. 

SR4 - Return address. 

D2 - DCBrSNT. 

D4 - X'22'. 




Remarks: 


Error in allocation. The specified entry in AVRTAB is not found or has bad flags. 




Code: 23 






Called From: 


CSE57, CSE59, CSEX560, CSEC'OM 




Message: 


INVALID ENTRY TO CSE HANDLERS 




Registers: 


- 




Remarks: 


Entry was made to an unused slot of the CSE branch vector for this machine. 




Code: 24 






Called From: 


CSEHAND 




Message: 


INSTRUCTION EXCEPTION TRAP IN MASTER MODE 




Registers: 


- 




Remarks: 


A trap X'4D' occurred while in the master mode. A slave mode trap causes a normal 
abort. All relevant information is in the in-core error log buffer. 


user job step 
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Table C-l. CP-V Software Check Codes (cont. ) 



Code: 25 




Called From: 


CSEHAND 


Message: 


UNRECOVERABLE WATCHDOG TIMER TRAP 


Registers: 


- 


Remarks: 


Sigma 9 and Xerox 560 systems will atempt recovery from watchdog timer traps resulting from I/O 
instructions without screeching. All relevant information is in the in-core error log buffer. 


Code: 26 




Called From: 


CSEHAND 


Message : 


CSE TRAP DURING MFI, PFI HANDLING 


Registers: 


- 


Remarks: 


During MFI handling on a Sigma 9 or during MFI or PFI handling on a Xerox 560, a CSE trap (X'46 1 , 
X'4C, X'4D') occurred. All relevant information is in the in-core error log buffer. 


Code: 27 




Called From: 


CSEHAND 


Message : 


PROCESSOR FAULT INTERRUPT 


Registers: 


- 


Remarks: 


A processor fault interrupt occurred for which continued operation is unlikely. All relevant infor- 
mation is in the in-core error log buffer. (Xerox 560 systems only. ) 


Code: 28 




Called From: 


CSEHAND 


Message : 


MEMORY PARITY ERROR -MEMORY ALTERED 


Registers: 


- 


Remarks: 


A memory parity error correction caused memory to be altered. Continuation without recovery is not 
possible. Caused by interrupt X'56 1 on Sigma 6 or 7 or trap X'4C in Sigma 9 or Xerox 560. All 
relevant information is in the in-core error log buffer. 


Code: 29-00 




Called From: 


CSEHAND 


Message : 


TRAP 4C - BUS CHECK FAULT 


Registers: 


- 


Remarks: 


A Sigma 9 bus check fault or a Xerox 560 miscellaneous trap X'4C' occurred while in the master 
mode. All relevant information is in the in-core error log buffer. 
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Table C-l. CP-V Software Check Codes (cont.) 



Code: 29-01 




Called From: 


CSEHAND 


Message: 


TRAP 4C -MAP PARITY ERROR 


Registers: 


- 


Remarks: 


A map register parity error occurred on a Sigma 9 or Xerox 560 while in the master mode. All rel- 
evant information is in the in-core error log buffer. 


Code: 29-02 




Called From: 


CSEHAND 


Message : 


TRAP 4C -REGISTER BLOCK PARITY ERROR 


Registers: 


- 


Remarks: 


A register block parity error occurred on the Xerox 560 while in the master mode. All relevant in- 
formation is in the in -core error log buffer. 


Code: 29-03 




Called From: 


CSEHAND 


Message : 


TRAP 4C -WRITELOCK REGISTER PARITY ERROR 


Registers: 


- 


Remarks: 


A write lock register parity error occurred on the Xerox 560 while in the master mode. All relevant 
information is in the in-core error log buffer. 


Code: 2C-00 




Called From: 


ADD 


Message: 


BATCH SCHEDULING ERROR - MBS/CCI ERROR 


Registers: 


Rl - (S:CUN) current user number. 

R2 - Device type. 

R3 - Context block address. 

R5 - 0. 

R6 - User's DCB address (M:C). 

SR2 - OPNLD + .14. 

SR3 - Context block address. 

SR4 - OPNLD + .40. 

Dl - BA (OPNLD + .1E7) + .28. 

D2 - BA(CONTXT BLK + SCFQARGS) + .28. 

D3 - Device type mnemonic text. 


Remarks: 


Register contents significantly different from above indicate the monitor wandered into GETI in ADD. 
Otherwise, a batch user has been created and has read a card before MBS selected him to be run. 
Actually all recorded 2C's have been CCI attempting to start a second job. Problem is either CCI 
read past FIN or a MBS/GETI communication problem (e.g., GIB:UN clobbered). 
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Table C-l. CP-V Software Check Codes (cont. ) 



Code: 2D-00 




Called From: 


COOP 


Message: 


COOPERATIVE BUFFER MANAGEMENT ERROR 


Registers: 


Rl - BUFLIMS index for screech code 19. 

R2 - .BC11. 

R3 - Context block. 

SR4 - COOP+ .18D. 

D3 - 0. 


Remarks: 


At context block initialization a buffer was allocated for the context block. This buffer has been 
lost through core clobbering or mismanagement of a buffer chain. The particular user cannot 
continue. 


Code: 2D-01 




Called From: 


COOP 


Message: 


SYMBIONT/COOP FILE DEVICE INACCESSIBLE 


Registers: 


R0 - COOP+ .19B. 

Rl - Context block physical address. 

R4 - (DCT3(DCTX)) will appear in the format XXIX XXXX, 

SR4 - COOP+ .15C. 

Dl - .XXFF0300 + DCTX (X means could be any value). 

D2 - BA (COOP BUFFER). 

D3 - .400. 

D4 - Disk address. 


Remarks: 


The symbiont/coop file device containing this user's file is down. If there are many file devices for 
symbiont/coop only, this user should be aborted. If only one symbiont/coop file device exists, it is 
pointless to run the system with that device down. 


Code: 2D-02 




Called From: 


COOP 


Message : 


USERS COOP CONTEXT BLOCK CHAIN LOST 


Registers: 


Rl - BUFLIMS index for screech code 19. 

R2 - .BC10. 

SR2 - OPNLD + .137. 

SR4 - OPNLD + .139. 

D3 - 0. 


Remarks: 


Similar to 2D-00 but detected at context block open time. Particularly alarming because this check 
immediately follows the code which allocates context blocks. 


Code: |2D-03 




Called From: 


SACT 


Message : 


COOP CONTEXT BLOCK POINTERS CLOBBERED 
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Table C-l. CP-V Software Check Codes (cont. ) 



Register: R3 - 0. 

R6 - User DCB address. 

SRI - FCN in leftmost 8 bits; DCB address in rightmost 24 bits. 

SR4 - Exit from COOP. 

Remarks: Either J:USCDX or context block (special pointers) were clobbered. 



Code: 2D-04 
Called From: 
Message : 
Registers: 



Remarks: 



SUPCLS 

COOP DATA BUFFERS MISALLOCATED 

D3 - Buffer being released, including spare buffer index in byte 0. 

R5 - Context block address and DBPOOL which is the address of the free context buffer list. 

R2 - SV:LSIZ. 

SR4 - Return address to caller of RCBUFF. 

An attempt was made to release a COOP data buffer when the free data buffer pool was full. Either 
the free data buffer pool has been clobbered or too many buffers have been allocated meaning some 
other COOP data area has been clobbered. 



Code: 2E 
Called From: 
Message: 
Registers: 

Remarks: 



RDF 

POOL BUFFERS LOST -NONE ALLOCATED CURRENTLY 

SR3 - DCB address for which buffer is needed. 
D4 - X'2E'. 

An attempt was made to get an IPOOL or FPOOL buffer, but none were in the free pool and no 
open DCB had any. Probably either the DCB chain has been clobbered or one or more DCBs have 
been clobbered. 



Code: 2E-01 

Called From: RA 

Message: INCONSISTENCY IN READ-AHEAD TABLES 

Registers: R12 - Disk address. 

Remarks: An attempt was made to add an AIR block to the tables when it was already there. 



Code: 30 
Called From: 
Message: 
Registers: 
Remarks: 



PFSR 



UNBALANCED POWER ON/POWER OFF INTERRUPT PAIRS 



Unbalanced power on/power off interrupt pairs, more of one than another (usually power on, or else 
system would hang in wait; i.e., B $-1). 
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Table C-l. CP-V Software Check Codes (cont. ) 



Code: 31 




Called From: 


GERM 


Message : 


INVALID RESOURCE TYPE 


Registers: 


SR4 - ADDRESS + 1 where discovered. 


Remarks: 


Invalid resource type found. 


Code: 32-00 




Called From: 


IOQ 


Message : 


DCB DOESN'T CONTAIN A VALID DCT INDEX 


Registers: 


R2 - Address of DCB. 


Remarks: 


The DCT index is not present in DCB. 


Code: 34-00 




Called From: 


TPQ1 


Message: 


TRANSACTION PROCESSING FAILURE 


Registers: 


- 


Remarks: 


The System Queue Manager for transaction processing has discovered an unrecoverable state while 
processing transactions. 


Code: 41-01 




Called From: 


RTROOT 


Message : 


FAILED TO FIND USER'S STATE (M:INTSTAT) 


Registers: 


R2 - Address of ICB being checked. 


Remarks: 


Probably results from a state having been added to SCHED without updating the four masks used by 
the M:INTSTAT routine (WAIT:MASK, EXU:MASK, IOWAIT:MASK, BLCKD:MASK). 


Code: 41-tDl 




: Called From: 


RTNR 


Message: 


BAD IOEX CALL TO NEWQ 


Registers: 


SetforBALR,ll NEWQNW. 


Remarks: 


NEWQNW returned to BAL + 1. 
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Table C-l. CP-V Software Check Codes (cont. ) 



Code: 41-11 








Called From: 


RTNR 






Message: 


UNABLE TO RETURN PRE-EMPTED DEVICE 






Registers: 


- 






Remarks: 


RTNR's call to RMAOV was invalid. 






Code: 43-01 








Called From: 


CLOCK4 






Message : 


NO ICBS CHAINED INTO RTICBCLKHDR 






Registers: 


- 






Remarks: 


This is probably caused by overwriting lowcore. 






Code: 43-02 








Called From: 


CLOCK4 






Message: 


ICBCLK FIELD OF ICB NEGATIVE 






Registers: 


R2 - Address of bad ICB. 
RIO - Current timer increment. 






Remarks: 


The ICBCLK field of an ICB should never go negative. 






Code: 43-03 








Called From: 


RTNR,CLOCK4 






Message: 


NO BACK-LINK FOUND IN DE-CHAINED ICB 






Registers: 


R2 - Current ICB (the one being de-chained). 
R4 - Forward link (next ICB in chain). 






Remarks: 


A back-link of zero implies that the current ICB is SYSICB1 (the 
should never be de-chained (i.e., de -activated). 


1 -second CLOCK3 ICB). 


This ICB 


Code: 46-21 








Called From: 


PV 






Message : 


PRIVATE VOLUME LOGIC INCONSISTENCY 






Registers: 


SR4 - Address where error was detected. 






Remarks: 


Numerous modules call PVERR. 
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Table C-l. CP-V Software Check Codes (cont. ) 



Code: 149 




Called From: 


TYPR 


Message : 


RESOURCE PREALLOCATION INCONSISTENT WITH REQUESTS 


Registers: 


|R3 - 0. 

R3 - Reel number. 
D4 - X'49'. 


Remarks: 


The user was preal located the resource (according to his job context), but when the system got to 
the point of actual allocation, it found that none of that resource was available. Either the job 
context specifying preal location is damaged or the system context recording actual allocation is 
damaged. 


Code: 56 




Called From: 


MOCIOP 


Message: 


UNABLE TO RELEASE PHYSICAL WORK PAGE 


Registers: 


The registers at the time of the trap. 


Remarks: 


Originates in the MOCIOP module when unable to release a physical work page locked in core 
during transaction processing ]/0 on a message-oriented controller (e.g., 7605). 


Code: M-00 




Called From: 


TEL 


Message: 


TEL ISSUED SINGLE USER ABORT ON YOU 


Registers: 


RI5 - Subcode. 


Remarks: 


The user already has SBUF1 at entry to TEL. This software check indicates a problem in memory 
management of physical pool pages. 


Code: 00-01 




Called From: 


TEL 


Message: 


TEL ISSUED SINGLE USER ABORT ON YOU 


Registers: 


- 


Remarks: 


TEL failed to get SBUF2 to read the assign/merge record. This software check indicates a problem 




in memory management of pool pages. 


Code: 00-02 




Called From: 


TEL 


Message : 


TEL ISSUED SINGLE USER ABORT ON YOU 


Registers: 


- 


Remarks: 


TEL failed to get SBUF2 for a GET. This is essentially the same as software check 60-01 (failed to 
get SBUF2 for READAM). A TEL logic problem or memory management failure is indicated. 
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Table C-I. CP-V Software Check Codes (cont. ) 



Code: 60-03 




Called From: 


TEL 


Message: 


TEL ISSUED SINGLE USER ABORT ON YOU 


Registers: 


SR4 - Contents of AM :LNK. 


Remarks : 


The assign/merge record is inconsistent with a user in the command file mode. AM:LNK (in the 
assign/merge record) should always point past the command file information, and it doesn't. 


Code: 60-04 




Called From: 


TEL 


Message: 


TEL ISSUED SINGLE USER ABORT ON YOU 


Registers: 


SR2 - The virtual page address through which TEL was trying to SAD (M:CVM). 


Remarks: 


This software check indicates a problem in memory management or a logic problem in TEL which 
caused the user's map to be left "dirty" from a previous SAD (M:CVM). 


Code: 01 - (TRAP Cell) 


Called From: 


INITRCVR 


Message: 


TEL OR CCI HAS TRAPPED 


Registers: 


Registers at time of trap. 


Remarks : 


The trap occurred while operating mapped, slave, and with TEL-in-control set. The subcode is 
the trap location. 


Code: 62 




Called From: 


SCHED 


Message: 


USER PROGRAM TOO LARGE FOR PHYSICAL MEMORY 


Registers: 


R0 - Pages freed. 

R4 - Inswap user (S:ISUN). 


Remarks: 


R0 > SL:CORE. User got swapped out but now can't fit back in. Pages may be released but not re- 
ported. The JIT in-core flag = 0. (UH:FLG X'200'.) 


Code: 63 




Called From: 


DPSIO 


Message: 


INSUFFICIENT INFORMATION AVAILABLE TO SWAP THIS USER 


Registers: 


R2 - IOCD. 

R6 - Command list address. 

R7 - Function code. 

D4 - X'63'. 


Remarks: 


Insufficient data to compute function, follow-on function code invalid, or flags not set properly. 
(Disk pack-only swappers. ) 
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Table C-1. CP-V Software Clock CocIrs (cont. ) 



Code: 6A 

Called From: MM 

Message: ATTEMPT TO RELEASE VIA M:CVM FROM USER W/O PROPER PRIVILEGE 

Registers: R1 - X'80'. 

R5 - Address of top of dynamic data or bottom of command . 

R6 - Number of pages to release. 

R7 - Virtual page number. 

SRI - Number of pages released. 

SR2 - First page to release. 

SR3 - Increment or decrement to next page. 

SR4 - Link. 

D1 - CC. 

D2 - CC mask. 

Remarks: Virtual page outside of user's area (BUP-EUP) was obtained by an M:CVM CAL, but the user lacks 

required privilege (X'80 1 ) to release it. 



Code: 6B 
Called From: 
Messages: 
Registers: 
Remarks: 



MM 

ERROR IN SPARE BUFFER TABLES 

Rl 1 - Address in buffer subroutine within MM (T:GBUF, T:RBUF, etc.) which detected the error. 

Usually due to bad input from the calling routine. 



Code: 6B 
Called From: 
Message: 
Registers: 

Remarks: 



SWAPPER 

ERROR IN SPARE BUFFER TABLES 

R6 - BA (window page). 

R14 - Physical page assigned to window. 

Page mapped into window is not contained in the spare buffer pool. 



Code: 78 
Called From: 
Message: 
Registers: 
Remarks: 



MPSCHED 

SLAVE CPU INITIATED RECOVERY 

R15 - Contents of S:SCRCH (specifying cause of screech in slave). 

Some significant problem was detected by a slave CPU which can be corrected only by a full system 
recovery (e.g., a trap with no assigned current user). 

Code: 79 

Called From: ENTRY 

Message: MONITOR COMMITTED A STACK TRAP 
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Table C-l. CP-V Software Check Codes (cont. ) 



Registers: 


Registers at time of trap. 


Remarks: 


Master bit on in PSD, overflow, underflow, or pointer to stack lost. 


Code: 79-01 




Called From: 


T:OV 


Message: 


MONITOR STACK TRAP 


Registers: 


Reg ; sters at time of trap. 


Remarks: 
Code: 7C 


OS7ACK overflow. 




Called From: 


ALTCP 


Message: 


ALTCP CALLED TO SERVICE A CAL THAT DOESN'T BELONG TO ALTCP 


Registers: 


R3 - Register field of CAL. 

R6 - First word PLIST. 

R7 - Address of PLIST + 1 . 

SRI - Code. 

SR4 - Exit address (usually TRAPEXIT). 


Remarks: 


A CAL1, 1 or CAL1,2 was passed to ALTCP but should have been handled by CALPROC. 


Code: 7E - (TRAP Cell) 


Called From: 


INITRCVR 


Message : 


MONITOR HAS TRAPPED 


Registers: 


Registers at time of trap. 


Remarks: 


Subcode is trap location. For traps that occur at locations less than X'8000' (JOVVPA), the 15 cells 
preceding the trap location and the trap location are stored in the monitor JIT at X'8DFO' — X'8DFF'. 


Code: 87 




Called From: 


ALLYCAT 


Message: 


ALLOCATION BUFFERS CONTAIN INVALID WORD COUNT 


Registers: 


Rl - Stack number. 
R2 - Stack count. 


Remarks: 


Either low core has been clobbered or someone has changed ALLYCAT's In-core data. 


Code: 88 




Cal led From: 


SCHED 


Messaje: 


ALLYCAT CLOBBERED ONE OF THE ALLOCATION BUFFERS 
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Table C-1. CP-V Software Check Codes (cont. ) 



Registers: 
Remarks: 



Rl 
R3 



Stack index. 
Stack count. 



ALLOCAT end-action has discovered a discrepancy in the granule/cylinder stacks. 



Code: 89-00 

Called From: ALLYCAT 

Message: ALLYCAT'S HGP CHAIN CLOBBERED 

Registers: 



Remarks 



R7 - Invalid HGP chain address. 

R9 - ALLOCAT internal link register. 

ALLOCAT data (HGPs and TABLES) has been destroyed. 



Code: 89-10 

Called From: ALLYCAT 

Message: DATA CHECKSUM ERROR 

Registers: None 

Remarks: ALLOCAT data (HGPs and TABLES) has been destroyed. 



Code: 93 
Called From: 
Message : 
Registers: 

Remarks: 



DPSIO, TSIO 

TDV COMMAND ADDRESS DOESN'T POINT TO COMMAND LIST 

Rl - 0. 

SRI - Command list address from TDV. 

SR2 - TDV status. 

D2 - Command list pointer (S:BECL,R1). 

IOP/memory failure; extraneous entry to TSIO/DPSIO not generated within CLIST. 



Code: 94 
Called From: 
Message : 
Registers: 

Remarks: 

Code: 95 
Called From: 
Message: 



DPSIO, TSIO 

COMMAND LIST CLOBBERED DURING WRITE CHECK 

SRI - Incorrect command list entry address. 

SR2 - TDV status. 

R12 - Order code from incorrect command list entry. 

Can't find seek or TIC within next five command list entries following error entry on write or write 
check. 



DPSIO, TSIO 

UNRECOVERABLE I/O ERROR READING USER'S JIT 
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Table C-l. CP-V Software Check Codes (cont. ) 



Registers: 


Rl - Inswap user number (S:ISUN). 




R7 - DCT index. 




SRI - Command list address from TDV status. 




SR2 - TDV status. 


Code: 96 




Called From: 


DPSIO, TSIO 


Message: 


UNRECOVERABLE I/O ERROR READING SHARED PROCESSOR 


Registers: 


Rl - Inswap user number (S:ISUN). 




R7 - DCT index. 




SRI - Command list address from TDV status. 




SR2 - TDV status. 



174 Appendix C 



APPENDIX D. XEROX 560 REMOTE ASSIST STATION 



INTRODUCTION 

The Remote Assist Station (RAS) and the associated routines 
comprise the CP-V interface for on-line remote assistance 
for both software and hardware analysts. This facility pro- 
vides an on-line connection to the operating system without 
requiring the use of any of the normal communications 
equipment. The RAS user has access to ELLA for listing and 
analyzing the contents of the system error log file (ERRFILE) 
and to ANLZ and Delta for examining crash dumps and the 
running monitor. 



HARDWARE INTERFACE 

The Remote Assist Station may be any ASCII terminal cap- 
able of connecting to the provided data set (Bell 103 A or 
its equivalent). The data set is connected to the Remote 
Channel Interface of the System Control Processor. (See 
the Xerox 560 Computer Reference Manual, 90 30 76. ) 
To use the interface on-line, the REMOTE CHANNEL 
switch on the Xerox 560 System Control Panel must be in 
the I/O position. This connects the remote channel to 
address X'OB' on the MIOP in cluster zero, through which i 
the CP-V interface communicates. This address must be 
SYSGENed as the Maintenance Control (MC) device. The 
hardware performs character translation from ASCII to 
EBCDIC (and vice versa) to make the terminal appear as 
an EBCDIC device. The translation tables are depicted in 
Table D-l. The left side of the table shows standard ASCII 
characters. The corresponding entries in the right side of 
the table show EBCDIC translation. 



— OM9T=l © (required for mounting tape dumps) 

__© 

-END© 

LOGON verifies the OMMC authorization before it ac- 
cepts the account and name, and will not allow the user to 
log on if he does not have this resource authorization. 

If the user's account and name are accepted, the user is 
logged on as a non-COC on-line user and LOGON exits to 
TEL which issues a prompt for input (!). 



processor Restrictions 

The MC authorization causes a :PROCS entry to be created 
for the RAS user which restricts him to the following list 
of processors: 

ANLZ 
Delta 
ELLA 

No other processors or programs are allowed at the RAS. 
Except for these processor restrictions, TEL will accept most 
of its commands (e.g., SET, PRINT, MESSAGE, QUIT, 
GO). However, commands regarding terminal type and 
status will be ignored. 



SOFTWARE INTERFACE 

CP-V provides an on-line communications interface enab- 
ling the remote analyst to log onto the Maintenance Console 
much as if he were connected to a COC terminal line. The 
interface is initiated at the Operator's Console (OC) by a 
special form of the GJOB key-in after the RAS is connected 
to the dial-up modem: 

IGJOB LOGON,MC 

This key-in causes LOGON to print a salutation to the MC 
resource requesting the RAS user to enter his account and 
name. The RAS user must be explicitly authorized via Super 
to use the MC resource. The following is an example of 
such a Super authorization: 

-C RAS, ASSISTANCE ® 

— O$PR=A0 © (required for running diagnostic 
programs) 

— OMMC=l© (authorizes on-line use of the MC 
resource) 



COMMUNICATIONS RESTRICTIONS 

The communications link to RAS uses a small resident 
handler in conjunction with the hardwired micro-coded 
controller to provide a terminal interface. Due to the 
limitations of the hardware and size restrictions on the 
software handler, some compromises have been made. The 
following list outlines the major characteristics of the com- 
munications interface: 

1. The MC device is a message mode device, requiring 
either LINE FEED, RETURN, CONTROL X, or CON- 
TROL H to end each input. LINE FEED and RETURN 
generate an X'15' (NL) character. CONTROL X and 
CONTROL H generate an X'08' (EOM) character which 
is used to cancel an input line so that the line may be 
retyped. 



2. Although the RAS terminal is connected in full-duplex, 
the MC device operates in half-duplex, echoplex 
mode, allowing I/O transfer a line at a time in only 
one direction. When a read is pending, characters 
typed will be echoed to the print mechanism of the 
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Table D-l. ASCII to EBCDIC Translate Table 




Notes: (jT)Used by Diablo Centaur terminal EOT/ACK protocol. 

\i) Used to cancel line, echoes as - — ®© and reissues read unless Delta is in control in which case is input as OA (LF). 

(V) Causes previously typed character to be ignored (Rubout character). 

(7) Lower case input is echoed lower case, but translated to upper case for program input. 
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terminal. If a read is not pending, characters typed 
are not echoed and are ignored. 

3. The BREAK key may be depressed at any time to in- 
dicate a BREAK signal. The MC handler causes a 
BREAK event to be issued for the user and counts suc- 
cessive BREAKs. If the user issues four successive 
BREAKs, the handler causes a CONTROL Y event 
(i.e., an escape to TEL). The BREAK key cancels any 
current J/O operation to the terminal. 

4. In order to detect line drop or disconnect, input re- 
quests will time out in three minutes and output mes- 
sages will time out in 20 seconds. A failure to respond 
to a read within three minutes causes the RAS user to 
be logged off. 

5. Records output to the RAS terminal have a maximum 
size restriction of 140 bytes. Trailing blanks in an 
output record are suppressed by the MC handler. Rec- 
ords output through DCBs other than M:UC have a 
RETURN/ LINE FEED appended to them. Records writ- 
ten through M:UC must contain their own carriage 
control characters. 

6. The MC handler does not simulate tabs nor does it 
affect pagination. 



7. Individual characters may be erased on input by typing 
@ characters for each character to be erased (e. g., 
'ANE@LZ' results in 'ANLZ 1 ). Complete lines may 
be erased by ending the line with CONTROL X or 
CONTROL H which causes the handler to echo 

©!© 
and to reissue the read that was in operation. 

8. End-of-file condition is set upon receipt of the three 
character sequence CONTROL F®. 

9. Lower case letters are echoed in lower case but are in- 
put to the program as upper case. 

10. When Delta issues a read, special action takes 
place by the handler to simulate the Delta activa- 
tion character set. Special Activation characters 
(CONTROL I , ) = /) should be immediately fol- 
lowed by a RETURN or LINE FEED. For commands 
which usually end with a RETURN, either a RETURN 
or a LINE FEED is valid. Commands which normally 
end in LINE FEED should be ended with CONTROL X 
or CONTROL H. Line erasure is effected by ending 
the line of input with ? RETURN. 
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APPENDIX E. ERRFILE FORMATS 



ERRFILE is a keyed file built and updated by ERRrFIL for 
use by diagnostic programs. The file contains one record 
for each error entry in the file created by ERRLOG. 

The keys for this file contain the Julian date in packed 
decimal, the time of the error in EBCDIC, and a sequence 
number for errors with the same time tag. This sequence 
number is reset to zero for each entry with a new time tag. 
The format of the key is 



yyOddd is the Julian date in packed decimal, 

hhmm is the time (hours and minutes) in EBCDIC, 

n is the sequence number. 



The first record of ERRFILE is the key of the last record in 
ERRFILE and has a key of zero. 



08 


yy 


0d 


dd 


h 


h 


m 


m 


n 









where 

08 is the number of bytes in the key. 



While copying records into ERRFILE, consistency and error 
checks are made on the input data. If any errors or in- 
consistencies are found, "copy error" records are written 
and a "copy error" counter in the summary record is in- 
cremented. The error and consistency checks, recovery 
actions taken, and the format of the copy error records are 
described below. The terminology used in the error record 
formats is defined in Table E-l. 



Table E-l. Error Record Terminology 



Term 


Meaning 


Account 


The doubleword used to identify a user's collection of files. 


AIOCC 


A 4-bit field representing the condition codes as returned by the hardware 
in response to an AIO instruction. 


AIO Status 


A 16-bit field representing the status as returned by the hardware in response 
to an AIO instruction. 


Alternate I/O Address 


A 16-bit value representing an alternate physical I/O address by which a 
dual-access device can be referenced. 


Bytes Remaining 


A 16-bit field representing the Remaining Byte Count (RBC) field as returned 
by the hardware in response to a TDV instruction. 


Consecutive, Keyed, Random 


Methods of organizing user files in CP-V (refer to the CP-V/BP Reference 
Manual, 90 17 64). 


Count of Entries Identical to 
Previous Entry 


The number of error log records which are identical to one previously logged 
for identical reasons (excludes time records). 


Count of Entries Lost 


The number of error log records lost when logging becomes temporarily im- 




possible for any reason. 


Current Command Doubleword 


A 64-bit value representing the command doubleword currently being pro- 
cessed for a device (indicated by the TDV status DW). 


CPU Address 


Hardward address of CPU performing the function (meaningful only for 
multiprocessing). 




Sigma 6 and 7 — 




Sigma 9 —port number 




Xerox 560 — basic processor address 
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Table E-l. Error Record Terminology (cont, ) 



Term 


Meaning 


Caller's Address 


The address back to which the error logging routine is returned when logging 
is complete; used in isolating software faults. 


DCT Index 


The 8-bit value indicating the order in which the device is configured into the 
system (at SYSGEN). 


DCT Index of Symbiont Device 


The 8-bit value indicating the order in which the device associated with the 
symbiont is configured into the system (at SYSGEN). 


Effective Address 


A 32-bit value representing the final address computed for the instruction 
pointed to by the instruction address (IA) in the PSD. 


Error Subcode 


An 8-bit field indicating which of several types of file inconsistencies has oc- 
curred (see CP-V/BP Reference Manual, 90 17 64). 


File Name 


The TEXTC name used to identify a collection of user data on secondary storage. 


Granule 


The unit of secondary storage allocation equal to 2048 bytes (usually 2 sectors). 


HIOCC 


A 4-bit value (bits 0-3 of designated byte) representing the condition codes as 
returned by the hardware in response to an HIO instruction. 


HIO Status 


A 16-bit value representing the status as returned by the hardware in response 
to an HIO instruction. 


I/O Address 


A 16-bit value representing the physical I/O address. 


I/O Count 


A 32-bit value representing the number of SIO instructions executed for the 
device. 


Julian Day 


A 16-bit value representing the Julian day of the year (e. g. , March 1 would 
be represented as X'3D') when the error was logged. 


Length 


A 8-bit value in the second byte of the error log record representing the num- 
ber of useful 32-bit words contained in the error log record. It includes the 
first word in the count. 


LMSCC 


The condition codes obtained when fetching a location via an LMS (Load Mem- 
ory Status) instruction. The condition codes indicate whether or not a parity 
error occurred during the fetch. 


Memory Status Words 
(Sigma 9 only) 


Each word is a 32-bit value representing data returned by the hardware in 
response to an LMS instruction. 
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Table E-l. Error Record Terminology (cont. ) 



Term 


Meaning 


MFI (Sigma 6 or 7 only) 


A 4-bit value representing the current state of the memory fault indicators 
returned by the hardware in response to an RD instruction. All memory fault 
indicators will be reset. 


Mode 


A ]6-bit value representing the manner in which the file was last referenced 
(see CP-V/BP Reference Manual, 90 17 64). 


Model Number 


A 16-bit value representing the model number assigned by Field Engineer- 
ing to uniquely identify peripheral devices (e.g., 7242 would be represented 
as X'7242'). 


Number of Parity Errors 


A 16-bit value representing the number of bad locations causing memory parity 
errors (only the first 14 bad locations are entered in the log if the number of 
errors is greater than 14). 


Primary I/O Address 


A 16-bit value representing the physical I/O address by which a device can 
be referenced (see Alternate I/O Address). 


PSD 


A 64-bit value representing the program status doubleword. 


Real Address 


A 32-bit value representing the actual memory address (in a mapped system, 
this is the same as the address in the IA field of the PSD). 


Recovery Count 


An 8-bit value initialized to zero at system initialization and incremented by 
the value one for every system recovery. 


Relative Sector Address 


A sector is 256 words. Each sector on a given device is numbered zero through 
device end. CP-V maintains file pointers by relative sector number, thereby 
simplifying the logic necessary to address different devices. 


Relative Time 


A 32-bit value representing milliseconds since midnight. Resolution is 2 msec. 


Relative Time Resolution 


An 8-bit value, n, such that actual relative time resolution = 2 msec, (e.g., 
n = 1 for a resolution of 500HZ or 2 msec. ). 


Retries Remaining 


An 8-bit value representing Retry Request minus the number of entries at- 
tempted. The range is between Retry Request and -1. A value of -1 indicates 
the operation was terminated due to retry count rundown. 


Retry Request 


An 8-bit value representing the maximum number of retries after which a device 
error is returned to the requester. This value is obtained from the requester's 
DCB. 


Screech Code 


The code used by CP-V to identify the system failure which has occurred. 
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Table E-l. Error Record Terminology (cont. ) 



Term 


Meaning 


Screech Subcode 


An 8-bit field identifying which type of a specific and similar set of system 
failures has occurred. (See Software check codes in the CP-V/OPS Reference 
Manual, 90 16 75.) 


Seek Address 


The physical disk address last used to access this device. 


Sense Information 


The diagnostic information returned from the device as a result of sending a 
"sense" order to the device. 


SIOCC 


A 4-bit value (bits 0-3 of designated byte) representing the condition codes 
as returned by the hardware in response to an SIO instruction. 


SIO Status 


A 16-bit value representing the status as returned by the hardware in response 
to an SIO instruction. 


Site Identification 


A 64-bit field containing the site ID from the SYSGEN :MON card left justi- 
fied with blanks on the right. 


Startup Type 


An 8-bit field indicating which of several types of system initialization was 
used. See the SYSTEM STARTUP error record (type X'18'). 


Subchannel Status 


The status of the I/O subchannel received from the hardware as a result of a 
TDV instruction. 


Symbiont File 


A CP-V system special file for buffering data between the CPU and slower 
speed line printers, card punchers, etc. 


TDVCC 


A 4-bit value (bits 0-3 of designated byte) representing the condition codes as 
returned by the hardware in response to a TIO instruction. 


TDV Current Command DA 


A 24-bit field representing the current command doubleword address used in 
obtaining the device status with a TDV instruction. 


TDV Status Doubleword 


A 24-bit field representing the subchannel status, as current command double- 
word, device status, and byte count as returned by the hardware in response to 
a TDV instruction. 


TIO CC 


A 4-bit value (bits 0-3 of designated byte) representing the condition codes as 
returned by the hardware in response to a TIO instruction. 


TIO Status 


A 16-bit value representing the status as returned by the hardware in response 
to a TIO instruction. 


Trap CC 


A 4-bit value (bits 0-3 of designated byte) representing the condition codes as 
returned by the hardware when certain traps occur. 
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Table E-l. Error Record Terminology (cont.) 



Term 


Meaning 


Trapped Instruction 


A 32-bit value representing the contents of the location pointed to by the 
instruction address (IA) in the PSD. 


Type 


An 8-bit value in the first byte of the error record which identifies the type 
of record . 


Unit Address 


A 6-bit value (bits 2 - 7 of designated byte) representing the address by which 
a processor can be referenced; the value is composed of a 3-bit cluster number 
followed by a 3-bit unit number. 


Unit Type 


An 8-bit value specifying the type of processor. Bit of the designated byte 
indicates the presence of the processor in the current operational configuration 
(0 = present, 1 = not present) . 


User ID 


A 16-bit value which is a unique number assigned by the system to the partic- 
ular job or on-line session. 


User Number 


An 8-bit value which is the index into internal system tables used to access 
user specific information. 


Version 


The version identifier of the system running (i.e., A00, BOO, etc.). This field 
is one byte in length. The letter of the version is stored in the first four bits 
and the number of the version is stored in the second four bits. 


Volume Serial Number 


A 4- or 6-byte field supplied by a user to identify either a tape or private 




pack. 


Year 


A 16-bit binary value representing the current year minus 1900 (e.g., 1973 is 
represented as X'49 1 ). 



READ ERROR 

If the condition codes set by TrRDERLOG indicate a read 
error, a copy error record (Read Error) is written and copy- 
ing of the record is attempted. If inconsistencies are found 
in the record, a copy of the bad record is placed in the 
ERRFILE file, followed by the End Read Error record. If no 
inconsistencies are found, the record is processed normally 
and the Read Error record remains in the ERRFILE file. The 
record formats are 



End Read Error 
word 



n 


Type 
X'10' 

1 2 3 1 4 5 6 7 


Length 
X'02' 

8 9 10 111 12 13 14 15 


16 17 18 19120 21 22 23 


Subtype 
X'Q2' 

24 25 26 27128 29 30 31 



word 1 



Relative time 



1 2 3 14 5 6 718 9 10 11)12 13 14 15116 17 18 19120 2! 22 23124 25 26 27128 29 30 31 



Read Error 
word 



Type 
X'10' 



Length 
X'02' 



Subtype 
X'OT 



i 2 3 t -4 5 6 7 I 8 9 10 111 12 13 14 15^6 17 18 19120 21 22 " 23 1 24 25 26 27 1 28 29 30 31 

word 1 



Relative time 



6 l' 2 3 U 5 6 7 I 8 9 10 llll2 13 14 15 1 16 17 18 I9I2O 21 22 23^4 25 26 27)28 29 30 31 



ERRLOG RECORD LENGTH ERROR 

If the length of the ERRLOG record is greater than 64 words, a 
copy error record followed by the ERRLOG record is written 
on ERRFILE. No attempt is made to copy this record in the 
detailed format. The record format is 

word 



Type 



Length 



X'lp' X'03' 

i 2 3 14 5 6 7 1 8 9 10 11M2 13 14 15 



16 17 18 I9T2O 21 22 23 



Subtype 
X'p3' 

24 25 26 27128 



25 26 27128 29 30 31 
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word 1 



Relative time 



1 i 3U { i Hi 9 16 I I Hi \i \i ts l U M \i i» l M 21 22 U \ U 0, 26 » l « » M jf 

word 2 



Index to bad entry 



1 2 3 I 4 5 6 7 I 8 9 10 111 12 13 14 15 1 16 17 18 I9I2O 21 22 23I24 25 24 27 1 28 29 30 3: 



INCORRECT TIME 

If the time of an entry is out of sequence, i.e., if it is 
earlier than the time of the last record and the data has not 
changed, a copy error record is written on ERRFILE followed 
by the ERRLOG record. The time of this entry is then used 
for the key and processing continues. The record format is 

word 



Type 
X'10' 



Length 
X'031 



Subtype 
X'05' 



0123l45«7l89 10 11112 13 14 I5I16 13 '18 I9I2O 21 22"23l 24 25 26 27I28 29 30 31 



word 1 



Relative time 



"5 i 2 3I4 5 6 7 Is 9 10 111 12 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27128 29 



word 2 



Index to bad entry 



1 2 3 14 5 6 7 18 9 10 11112 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 

where index is the displacement within the ERRLOG record 
of the first word of erroneous entry. 



ILLEGAL ENTRY TYPE 

If the entry type is not one of the legal types, a copy error 
record followed by the ERRLOG record is written on ERRFILE. 
No attempt is made to copy the remainder of the record. 
The record format is 



Note: Errors that occur while booting have a time tag of 
24XX but the keys of these records contain the cur- 
rent date and 001 1 for the time. 

If read or write errors are detected while reading or writing 
ERRFILE and SUMFILE, they are ignored. 

Whenever I/O errors or certain unusual conditions occur, 
an entry will be made into ihe ERRLQG file. This entry 
will contain any information ipertinent to the condition. 

Word of each entry will have a code indicating which 
error or unusual condition is present along with the number 
of words in the entry (including word 0). Time (hhmm) and 
Device Name (yyndd) are in EBCDIC. 

There are no error log entries for the following two interrupts. 



MEMORY FAULT INTERRUPT 

The Memory Fault Interrupt (MFI) is triggered when an error 
is detected during a memory access by either the CPU or an 
IOP. If the MFI is triggered by the CPU, a parity error trap 
will also occur unless the error is a Loop Check Parity error 
or Overtemperature condition. The parity error trap routine 
performs error recovery, logs the error, and clears the MFI 
to avoid duplicate processing. The MFI service routine 
therefore expects to only handle errors detected during an 
IOP memory access and Loop Check and Overtemperature 
errors. The Loop Check and Overtemperature errors are 
processed by the memory parity program and the system re- 
covery program is entered with code X'23'. The other er- 
rors are logged by the device handler, which also performs 
the required recovery. 



PROCESSOR FAULT INTERRUPT 

The Processor Fault Interrupt is not enabled in CP-V. Errors 
that cause this interrupt in a monoprocessor system are han- 
dled by the I/O Interrupt Routines. 



SIO FAILURE 

This record is logged when CO and/or CC2 are set after 
execution of the SIO instruction. 



word 



Type 
X'10' 



Length 
X'03' 



■M.M. i .M.'.j.^Al-.'. 1 ^. 11 . 1 . 1 . 1 



Subtype 
X" 



27128 



i 2 3 14 5 6 7 18 9 10 11 1 12 13 14 151 16 17 18 19120 21 22 23|24 25 26 27128 29 30 31 

word 1 



Relative time 



i 2 3 I 4 5 6 7 I 8 9" 10 111 12 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



word 2 



Index to bad entry 

T~2^ 3 I 4 5 6 7 I 8 9 10 111 12 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



where index is the displacement within the ERRLOG record 
of the first word of erroneous entry. 



word 



Type 
X'lT 



12 3 14 5 6 7 



Length 
X'06' 



8 9 10 111 12 13 14 15 



Model number 



16 17 18 19120 21 22 23124 25 26 27(28 29 30 31 



word 1 



Relative time 



32 33 34 35 1 36 37 38 39 1 40 41 42 43 1 44 45 46 47 1 48 49 50 51 1 52 53 54 55 1 56 57 58 59 1 60 61 62 63 



word 2 



SIO status 



1 2 3 14 5 6 7 18 9 10 11 1 12 13 14 15 



I/O address 



16 17 IB 19120 21 22 23T24 25 26 27T28 29 30 31 
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word 3 



word 9 



MFI (if 
Sigma 6 or 7) 



SIOCC 



TDVCC 



1 2 3 I 4 5 6 7\t 9 10 llll2 13 14 15 1 16 17 18 19 1 20 21 22 23124 25 26 27T28 29 30 31 



word 4 



Subchannel 
status 



iM3 



TDV current command DA 



1 2 3 I 4 5 6 7 18 9 10 111 12 13 14 15 1 16 17 18 19l» 21 22 23 1 24 25 26 27 1 28 29 30 31 

word 5 



TDV status 



I 2 3 I 4 5 6 7 I 8 9 10 ll! 12 13 14 15 



TIME OUT 



Bytes remaining 



16 17 18 19120 21 22 23124 25 26 27128 29 30 31 



This record is logged when the I/O interrupt does not occur 
within a specified time period in response to an I/O 
instruction. 

word 



Type 
X'12' 


Length 
X'OD' 


1 1 

Model number 


1 2 3 U 5 6 7 


8 9 10 111 12 13 14 15 


16 17 18 I9I2O 21 22 23I24 25 26 27 1 28 29 30 31 



word 1 



Relative time 



i 2 3~tl 5 6 7 I 8 9 10 11 I 12 13 14 15 1 16 17 18 I9I2O 21 22 23 1 24 25 26 27I28 29 30 31 



word 2 






1 2 3 U 


HIO status 

5 6 7 1 8 9 10 111 12 13 14 15 


I/O address 

16 17 18 19I20 21 22 23I24 25 26 27I28 29 30 31 



word 3 








MFI (if 
Sigma 6 or 7) 


HIO CC 


TDV CC 


TIOCC 


1 2 3 1 4 5 6 7 


8 9 10 111 12 13 14 15 


16 17 18 19I2O 21 22 23 


24 25 26 27I28 29 30 31 



word 4 



Subchannel 
status 



TDV current command DA 



12 314 5 6 7 18 9 10 11112 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 



word 5 








TDV status 


Bytes remaining 


12 3 


4 5 6 7 18 9 10 11 


12 13 14 15 


16 17 18 19I20 21 22 23I24 25 26 27 1 28 29 30 31 



words 6 and 7 



Current command 
doubleword 

i 2 3 I 4 5 6 7 I 8 9 10 111 12 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



word 8 



TIO status 



1 2 3T4 5 6 7 18 9 10 11T12 13 14 15 



Retry 
request 

17 18 19l20 21 22 



Retries 
remaining 



I/O count for this device 



123l4567l89 10 llll2 13 14 15ll6 17 18 19l20 21 22 23I24 25 26 27I 28 29 30 31 

words 1 and 1 1 



Volume serial number 



(Six characters for 
ANS tapes) 



123 14 567189 10 11 1 12 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 



Original 
function code 



Current 
function code 



word 12 



Seek address 



"CTT 2 3 I 4 5 6 7 I 8 9 10 111 12 13 14 15ll6 17 18 I9I2O 21 22 23 1 24 25 26 27I28 29 30 31 

UNEXPECTED INTERRUPT 

This record is logged when an interrupt, other than an at- 
tention interrupt, is received from a known device for 
which no I/O operations have been started by the system. 

word 



Type 
X'J3' 



Length 
X'04' 



Model number 



1 2 3 14 5 6 7 18 9 10 11112 13 14 15 16 17 18 19T20 21 22 23124 25 26 27128 29 30 31 



1 24 25 26 27h 



word 1 



Relative time 



1 2 314 56 7 18 9 10 11112 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 



word 2 



AIO status 



I/O address 



1 2 3 1 4 5 6 7 18 9 10 11 1 12 13 14 15 16 17 18 19120 21 22 23l24 25 26 27|28 29 30 31 



word 3 



*F< 


— 1 

illllllill 


■- ■ ■■ ■ 

AIOCC 

8 9 10 ill 12 13 U 15 


ii 'V ' W ■ \ft»%' »' 'Mfc' OT •$»' 'ft' 'JO' 4 



DEVICE ERROR 

This record is logged when general analysis of the status re- 
ceived from an AIO, TDV, or TIO indicates an error which 
resulted from the I/O operation. For on-line diagnostic I/O, 
this information is returned in the STATUS area defined by 
M:DOPEN with the type code X' 14' for normal completion. 

word 



Type 
X']5' 



Length 
X'OD' 



Model number 



1 2 3 14 5 6 7 18 9 10 11 1 12 13 14 151 16 17 18 19120 21 22 23124 25 26 27128 29 30 31 



word 1 



Relative time 



24 25 26 27128 29 30 31 



U 5 6 7 I 



1 2 3 14 5 6 7 18 9 10 III 12 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 
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word 2 



word 



AIO status 



1 2 3 I 4 5 6 7 I 8 9 10 11 1 12 13 14 IS 16 17 18 19 1 20 21 22 23 1 24 25 26 27! 



I/O address 



27128 29 30 31 



word 3 



MFI (if 
Sigma 6 or 7) 



AIOCC 



12 3 I 4 5 6 7 18 9 10 111 12 13 14 15 1 16 17 18 19l 20 21 22 23I24 25 26 27 1 



TDVCC 



TIOCC 



25 26 27128 29 30 31 



word 4 



Subchannel 
status 



TDV current command DA 



1 2 3 I 4 5~ 6 7 18 9 10 111 12 13 14 IS I 16 17 18 I9I 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



word 5 



TDV status 



Bytes remaining 



i 2 3 I 4 5 6 7 I 8 9 10 111 12 13 14 15I 16 17 18 19I2O 21 22 23 1 24 25 26 27 1 28 29 30 3 



words 6 and 7 



Current command 
doubleword 



i 2 3 I 4 5 6 7 I 8 9 10 111 12 13 14 15l 16 17 18 19I2O 21 22 23 1 24 25 26 27 1 28 29 30 3' 



Type 
X'16' 



Length 
(variable) 



I/O address 



<5T 2 3 14 5 6 7 Is 9 10 111 12 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 

word 1 



Relative time 



1 2 3 I 4 5 6 7 I 8 9 10 111 12 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 26 29 30 31 



words 2 and following 



Sense information (left justified) 

Device Length (in bytes) 

7242 10 

Disk A, B 16 

1600 bpi tape 6 

9T tape 1 j 

1 RAD 3 ! 



i 2 3 I 4 5 6 7 Is 9 10 11 1 12 13 14 15 1 16 17 18 19 1 20 21 22 23) 24 25 26 27 1 28 29 30 31 

The I/O address links the secondary record to the cor- 
responding device error entry. 



word 8 



TIO status 



Retry 
request 



Retries 
remaining 



1 2 3 I 4 5 6 7 I 8 9 10 111 12 13 14 15116 17 18 19 1 20 21 22 23 1 24 25 26 27I28 29 30 31 



word 9 



I/O count for this device 



123l4567l89 10 111 12 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



words 10 and 11 



Volume serial number 



(Six characters for 
ANS tapesV 

i 2 3 I 4 5 6 7 I 8 9 10 11 1 12 13 14 15 



Original 
function code 



16 17 18 19120 21 22 23 



Current 
function code 

24 25 26 27128 29 30 31 



SYSTEM STARTUP 

This error is logged at system initialization and at every 
recovery. 

word 



#» 



Length 
X'04' 



Startup 
type 



1 2 314 5 6 7T8 9 10 11112 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 



Recovery 
count 



word 1 



Relative time 



1 2 3 I 4 5 6 7 I 8 9 10 111 12 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



word 12 



Seek address 



i 2 sU 5 6 7U 9 10 111 12 13 14 15 1 16 17 18 19I2O 21 22 23 1 24 25 26 27I28 29 30 31 



SECONDARY RECORD FOR DISK PACK, RAD, AND 
TAPE 

This record is generated as a result of a previous device 
error and contains device status which corresponds to the 
information contained in the Device Error record (type 
X'15') preceding this record. 



word 2 



Year (last two digits; 
in binary) 



Julian day (in binary) 



12 3 14 5 6 7 18 9 10 11112 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 



word 3 



Screech code 



Screech 
subcode 



CPU address 



i 2 3U 5 6 7 Is 9 10 111 12 13 14 15116 17 18 19 1 20 21 22 23I24 25 26 27 1 28 29 30 31 



where 



screech code and screech subcode are defined in 
the CP-V/OPS Reference Manual, 90 16 75. 

recovery count is set to for initial startup as de- 
fined by startup types 1, 2, or 3 below. 
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startup type specifies the type of startup. 

1 - Initial PO boot 

2 - PO boot with files 

3 - System device boot (no recovery) 

4 - System recovery 

5 - Operator recovery 

6 - Secondary CPU startup 

7 - Secondary CPU shutdown 



word 12 



Generalized disk address 



i 2 3 U 5 6 7 I 8 9 10 111 12 13 14 isl 16 17 18 1»Im 21 22 23I24 25 26 27I28 29 30 31 



word 13 



ORG 



I 4 5 6 7 I 



1 2 3 14 5 6 7 18 9 10 11112 13 14 15 



MODE 



1 1 20 21 22 23 1 



16 17 18 19120 21 22 23124 25 26 27728 29 30 31 



where 



ORG is set to 1 for consecutive, 2 for keyed, and 
3 for random. 

MODE is set to 1 for IN, 2 for OUT, 4 for INOUT, 
and 8 for OUTIN. 



(For type 6 and 7, screech code fields and re- 
covery count are zero. ) 



FILE INCONSISTENCY ERROR 

This record is logged if the system detects files which are 
inconsistent in that the associated file links do not match 
or are otherwise incorrect. 



word 



Type 
X'lA' 



Length 
X'OE' 



75 



Error 
subcode 



I 2 3 I 4 5 6 7 18 9 10 111 12 13 14 15M6 17 18 19! 20 21 22 23124 25 26 27128 29 30 31 

word 1 



Relative time 



ll 12 13 14 15 1 



1 2 3 T4 5 6 7l8 9 10 111 12 13 14 15H6 17 18 19120 21 22 23124 25 26 27 1 28 29 30 31 



words 2 through 9 



SOFTWARE-DETECTED SYMBIONT INCONSISTENCIES 

This record is logged if the system detects files which are 
inconsistent in that the associated file pointers do not match 
or are otherwise incorrect. 

I word 



Type 
X'lB' 



Length 
X'03' 



DCT index 
of symbiont 



8 I 2 i\i 5 & 7 I 8 9 tft lllli 13 U 15116 17 18 19li0 21 22 23 1 24 25 26 27 1 46 29 30 31 



word 1 



Relative time 



1 2 3 14 5 6 7 18 9 10 11112 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 



word 2 



Generated disk address 



U 5 6 7 I 



j 2 3 14 5 6 718 9 10 lTTl2 13 14 15U6 17 18 19120 21 22 23(24 25 26 27(28 29 30 31 



words 4 and 5 



Reserved for future use 



i 2 3 I 4 5 6 7le 9 10 III 12 13 14 15ll6 17 18 19 1 20 21 22 23I24 25 26 27I28 29 30 31 



File name 



8 I } 3U 5 A 7 la 9 10 til 12 13 U tslti 1) tS 19I26 21 55 2M24 is Ji 27I28 » 36 M 

words 10 and 1 1 



Account number 



i 2 3 I 4 S 6 Ttl 9 10 111 12 13 14 15ll6 17 18 19l20 21 22 23 1 24 25 26 27 ) 28 29 30 31 



word 6 



Real address of trapped instruction 



0~~ i 2 3 I 4 5 6 7 I 8 9 10 111 12 13 14 IS I 16 17 18 19I2O 21 22 23I24 25 26 27I28 29 30 3 



word 7 



Trapped instruction 

i 2 3 I 4 5 6 7le 9 10 111 12 13 14 15 1 16 17 18 19I2O 21 22 23 1 24 25 26 27(28 29 30 31 



word 8 



ANLZ CC 



Effective virtual address 



I 2 3 I 4 5 6 718 9 10 111 12 13 14 15l 16 17 18 19I2O 21 22 23 1 24 25 26 27 1 28 29 30 31 
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word 9 



Effective real address 

n i i i \ i s i H§ » ta n l h a u )i l u v \& t» l « ii 22 a l M it & »!« m a at ' 



where FIP, IAP, RBP, and ANLZ CC have the same mean- 
ings as for the hardware error record (X'17 1 ). 



LOST ENTRY INDICATOR 

This record is entered when buffering constraints make error 
logging temporarily impossible. The newest entries are lost. 

word 



Type 
X'lE' 



Length 
X'Q2' 



Count of entries lost 



II I 3 3 U $ I 7 Is i to \\ \ \i ii U \i\\i l» \6 \t \ X> i\ B tt l ^ is 26 i) \ ll V> 30 it 



word 1 



Relative time of last lost entry 



i 2 3 I 4 5 6 7U 9 10 II 1 12 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



DUPLICATE ENTRIES 

This record is logged if duplicate error log entries are 
generated. 



CONFIGURATION RECORD 

This record is logged at system startup. 

word 



Type 
X'2I 



Length 



■.AU'.W.WiJIU.H*!. 



iS^&wss; 



> Wfrl',1 A - Ww». t*S$*tmJ 



6 1 i 3U 5 6 7 I s 9'to ii l i2 13 ti isPfHHHf T ^HY ' 
word 1 



Relative time 



I I 4 5 6 7~tl 



} I 20 21 22 23 1 2 



1 2 3 14 5 6 7 18 9 10 11112 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 

word 2 



Model number 

i 2 3 I 4 5 6 7 I 8 9 10 111 12 13 14 15 



^ DCT index 

V6"V7"V8" lVTio" "2122 ! 23 1 24 25 26 27 1 28 29 30 31 



word 3 



Alternate I/O address 

1 2 3 I 4 5 6 7 I 8 9 10 111 12 13 14 15 



Primary I/O address 

16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



additional words 



f 



Words 2 and 3 may be repeated up 
to four times. The pairs of words 
will be in order by DCT index. 
Multiple records may occur. 



' ^ 3 U 5 6 7 Is 9 10 11 1 12 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 3 



word 



Type 
X'lF' 



Length 
X'02' 



Number of entries identical 
to previous 



1 2 3 U 5 6 7 Is 9 10 11 1 12 13 14 15 1 16 17 18 I9I2O 21 22 23I24 25 26 27 1 28 29 30 31 

word 1 



Relative time of last duplicate 



"0 i 2 3I4 5 6 7 Is 9 10 1lll2 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



SYSTEM IDENTIFICATION 

This record is entered at system startup and recovery and is 
entered after the CONFIGURATION RECORD (type X'2T). 

word 



X^T 



Length 
X'05' 



Core size (in 
8K word blocks) 



Relative time 
resolution 



1 2 3 14 5 6 7 I 8 9 10 11112 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 



POWER ON 

This record is generated as a result of the power on trap 
associated with location X'50 1 . 

word 



Type 
X'20' 

14 5 6 7 



1 2 3 14 5 

word 1 



wioqi CPU address 

10 llll2 13 14 I5ll6 17 18 19l20 21 22 23l24 25 26 27I28 29 30 31 



Relative time 



1 2 3 I 4 5 6 7 I 8 9 10 111 12 13 14 15l 16 17 18 19l 20 21 22 23 1 24 25 26 27 1 



word 1 



Relative time 



I I 4 5 I 7~t 



1 2 3 14 5 6 7 18 9 10 11112 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 



1 20 21 22 23I2 



word 2 



System version flags (loc 2B) 



1 2 3 I 4 5 6 7 I 8 9 10 111 12 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



words 3 and 4 



Site identification (in EBCDIC) 



TJ I 2 3 I 4 5 6 7~"t"8 9 10 1 1 I 12 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 3 
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TIME STAMP 



This record is entered once each hour on the hour. 



word 3 (if type code = 0) 



Address of routine calling ERRLOG 



0""i 2 3 U 5 6 Hb 9 10 III 12 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27I26 29 30 31 



word 



Type 
X'23' 

0~" 1 2 3 L 5 6 7 



Length 
X'03' 



Wi^ l ^itWii^M^f^^li^tiitWe^i^iil^ i 



9 10 111 12 13 14 15 



16 17 IB 19120 21 22 23124 25 26 27128 29 30 31 



word 3 (if type code = 1) 



Number of graules 
being released 



• ' r * ! 

MMMR 



\.*wim 



I 2 314 5 6 718 9 10 11112 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 



120 21 22 '23124 25 26 27 1 2 



word 1 



Relative time 



i 2 3 I 4 5~" 6 7 Is 9 10 111 12 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



word 2 



Year (last two digits; 
in binary) 



i 2 3 I 4 5 6 7 I 8 9 10 11 1 12 13 14 15 



Julian day (in binary) 



16 17 18 19l20 21 22 23l24 25 26 27 1 28 29 30 31 



REMOTE PROCESSING ERROR 

This record is logged when an error occurs in the transmis- 
sion of data to or from a remote processing workstation. 

word 



Type 
X'26' 



Length 
X'08' 



I/O address 



1 2 3 14 5 6 718 9 10 11 1 12 13 14 151 16 17 18 19120 21 22 23124 25 26 27128 29 30 31 



word 1 



Relative time 



1 2 3 14 5 6 7 18 9 10 11112 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 



word 2 



RBrFLAGS 

i 2 3U 5 6 ?U 9 10 111 12 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



BAD GRANULE RELEASE 



words 3 and 4 



Workstation name 



S I i i U 4 6 7 is 9 16 llll2 13" W l5l*6 17 18 l*li0 21 22 JslW 25 26 27li4 29 3* 31 



This record is logged if the granule being released contains 
an invalid disk address or has already been released (dual 
allocation). 



word 



x T ^ 



1 2 3 14 5 6 7 



Length 
X'04' 



9 10 1TTT2 13 14 15 



Type code (0-bad address; 
1-dual allocation) 



words 5 and 6 



Current command doubleword 



1 2 3 I 4 5 6 7 Is 9 10 11 1 12 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



16 17 18 19120 21 22 23124 25 26 27128 29 30 31 



word 7 












RP1 


RP2 


RP3 


RP4 


1 2 3 1 4 5 


i 7 


8 


> 10 111 12 13 14 15 


16 17 18 I9I2O 21 22 23 


24 25 26 27I28 29 30 31 



word 1 



Relative time 



1 2 3 I 4 5 6 7 I 8 9 10 111 12 13 14 15ll6 17 18 I9I2O 21 22 23 1 24 25 26 27I28 29 30 31 



word 2 



Generated disk address 



i 2 3 I 4 5 6 7 I 8 9 10 111 12 13 14 15l 16 17 18 19I2O 21 22 23I24 25 26 27I28 29 30 31 



where 

type identifies the type of error log record. 

length specifies the number of 32-bit words con- 
tained in the error log record. 

I/O address is a 16-bit address representing the 
physical I/O address. 

relative time represents milliseconds since mid- 
night. Resolution is 2 msec. 
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RB-.FLAGS specifies the contents of RB:FLAG at the 
time of the error. RB:FLAG is described in the 
CP-V/Data Base Technical Manual, 90 19 95. 

workstation name specifies the workstation name 
(in TEXT format, left-justified and padded with 
blanks) if the terminal is logged on. 

current command doubleword specifies the command 
doubleword of the i/Othat was taking place when 



the error occurred. For Xerox 7670 RBTs, the 
current command doubleword contains the second 
command doubleword used to write the text of an 
output message and is meaningful only for RP1 =0, 
1, A, or B. 

RP1, RP2, RP3, and RP4 have specific meaning for 
the type of remote workstation associated with the 
record. The meanings are listed in Tables E-2 
through E-7. 



Table E-2. Xerox 7670 RBT - RP1 , RP3, and RP4 



RP1 Value 


Meaning 


Corresponding RP3 Meaning 


Corresponding RP4 Meaning 


1 


First character in record not SOH. 


Current character position. 


Offending character. 


2 


Incorrect parity on SEL. 


Current character position. 


Offending character. 


3 


Incorrect block protect. 


Current character position. 


Offending character. 


4 


Third character in record not STX. 


Current character position. 


Offending character. 


5 


RBBAT COMBUF or MPOOL unavailable 
for log-on . 


Meaningless. 


Meaningless. 


6 


Incorrect character parity. 


Current character position. 


Offending character. 


7 


Record trailer character not ETX. 


Current character position. 


Offending character. 


8 


Incorrect block check parity. 


Current character position. 


Offending character. 


9 


Incorrect block check. 


Current character position. 


Offending character. 


A 


Communication line time-out. 


Meaningless. 


Meaningless. 


B 


NAK received. 


Response received reading for ACK. (RP3 and RP4 combine 
to be a halfword). 


C 


Garbled ACK or NAK. 


Response received reading for ACK. (RP3 and RP4 combine 
to be a halfword). 
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Table E-3. Xerox 7670 RBT - RP2 



Table E-4. IBM 2780 RBT - RP1 and RP4 



RP2 Value 





1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

10 

11 

12 

13 

14 

15 



Meaning (Current Function Code) 



Write card punch. 

Write line printer. 

Send ACK. 

Write TOF (Block protect = 0). 

Write TOF (Block protect = 1). 

Write SPACE (Block protect = 0). 

Write SPACE (Block protect = 1). 

Read card reader. 

Write TOF (log-on). 

Read card reader (special). 

Read ACK card punch. 

Read ACK line printer. 

Read ACK TOF (Block protect = 0). 

Read ACK TOF (Block protect = 1). 

Read ACK SPACE (Block protect = 0). 

Read ACK SPACE (Block protect = 1). 

Write EOT. 

Write DC1. 

Write ACK (special). 

Write NAK. 

Write NAK (special). 

Write BEL (on error). 



RP1 
Value 



Meaning 



Disconnect due to 

a. EOT on read. 

b. Use of 2780 on 
IRBT only system. 

Line timeout. 

ENQ not received 
on logon read. 

No EOT after EOF sent. 

a. ENQ in text mode. 

b. No ENQ answer- 
ing WACK. 

c. ENQ answer to 
ACK of EOF. 

NAK received. 

CRC failed on input. 



Unknown response 
reading for ACK. 

Trailer character not 
ETB or ETX. 



Header character not 
STX. 



Corresponding RP4 
Meaning 



EOT 
ENQ 

Same as RP2. 
Character received. 

Character received. 

Character received. 
Character received. 

Character received. 
Character received. 



Last character 
CRCed. 



Character received. 



Character received. 



Character received. 



Table E-5. IBM 2780 RBT - RP2 and RP3 



Value 


RP2 (Current Function Code) 


RP3 (Calling Function Code) 





Disconnect. 


Software error — should not occur. 


1 


Write data. 


Write. 


2 


Send ENQ. 


Send ENQ (Wait). 


3 


Send ACK O. 


Read. 


4 


Send WACK. 


Send WACK (Wait). 
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Table E-5. IBM 2780 RBT - RP2 and RP3 (cont. ) 



Value 


RP2 (Current Function Code) 


RP3 (Calling Function Code) 


5 


Write data. 




Write EOF. 


6 


Send ENQ. 




Request to output. 


7 


Read for ACK, ENQ, EOT (depends on RP3). 


POL for input. 


8 


Read for ENQ. 




Logon. 


9 


Read. 




Software error — should not occur. 


A 


Send NAK. 




Software error — should not occur. 


B 


Send AC K 1. 




Software error — should not occur. 


C 


Send EOT. 




Software error — should not occur. 



Table E-6. IRBT - RPl and RP4 



RPl 
Value 


Meaning 


Corresponding RP4 Meaning 





Recoverable block check error. 


Difference (mod 16) between expected 
and received BCBs. 


1 


Catastrophic block check error (NAK sent 
in case of line error). 


Difference (mod 16) between expected 
and received BCBs. 


2 


Communication line time-out. 


Same as RP2. 


3 


Read for ENQ timed-out (logon). 


Same as RP2. 


4 


Received ACK O instead of SIGNON at logon. 


ACK O 


5 


Inappropriate line bid (not ENQ-master, not 
ACK O-slave). 


Line bid received. 


6 


NAK received. 


NAK. 


7 


Read timed out. 


Same as RP2. 


8 


Incorrect CRC. 


Last character CRCed. 


9 


Trailer character not ETB. 


Offending character. 


A 


Leader character not STX. 


Offending character. 


B 


Lost data. 


First character after IDLE. 


C 


Garbled ACK O-NAK. 


First character of message. 
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Table E-7. IRBT - RP2 


and RP3 


Value 


RP2 (Current Function Code) 


RP3 (Calling Function Code) 





Disconnect. 


Software error — should not occur. 


1 


Write block. 


Write block — read block. 


2 


Write AC K. 


Write ACK - read block. 


3 


Write block. 


Write block (Wait-a-bit) — Read special. 


4 


Write Wait-a-bit. 


Write Wait-a-bit — Read special. 


5 


Read block. 


Software error — should not occur. 


6 


Send NAK. 


Software error — should not occur.'' 


7 


Send ENQ. 


Logon as Slave. 


8 


Read for ENQ. 


Logon as Master. 


9 


ACK O to ENQ. 


Logon as Master after ENQ Read. 


A 


Read logon record. 


Software error — should not occur. 


B 


NAK logon record. 


Software error — should not occur. *" 


If errors with the same RP1 code occur consecutively, this code may appear in the RP3 field for the second and subsequent 


consecutive errors, replac 


:ing another legal RP3 code. 





OPERATOR MESSAGE 

This record is interjected as the resultofan operator ERRS END 
key-in or by a diagnostic program. It is generally used to de- 
scribe unusual conditions surrounding a particular error. 

word 



Type 
X'27' 



Length 
(variable) 



mm 



1912 



312 



1712 



Wl 



vv v iW«f'i 



1 2 3 14 5 6 718 9 10 11112 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 

word 1 



Relative time 



word I 



Relative time 



I 2 3 U 5 6 7 I 8 9 10 111 12 13 14 15 1 16 17 18 I9I2O 21 22 23 1 24 25 26 27 1 28 29 30 31 

word 2 



I/O address 



DCT index 



123l4 567l89 10 1lll2 13 14 15 1 16 17 18 ]9l20 21 22 23 1 24 25 26 27 1 28 29 30 31 

word 3 



I/O count 



1231456 71 89 10 11112 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 



1 2 3 I 4 5 6 7 I 8 9 10 111 12 13 14 15 1 16 17 18 19 ! 20 21 22 23I24 25 26 27I28 29 30 31 

additional words 



word 2 



; 



Message from the operator in TEXTC 
format. (Maximum size is 71 characters 
plus the count byte.) 



1 2314567 T8 9 10 11112 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 



Words 2 and 3 may be repeated up to four 
times. The pairs of words will be in order 
by* DCT index. Multiple records may occur. 



T 2 3 I 4 5 6 Til 9 10 111 12 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27l 



21 22 23124 25 26 27128 29 30 31 



I/O ACTIVITY COUNT 

This is recorded once per hour and at recovery, 
word 



Type 
X'28' 



1 2 3T4 5 6 7 



Length 
(variable) 



9 10 11112 13 14 15 



DCT index of first device 



16 17 18 19l20 21 22 23I24 25 26 27 1 28 29 30 31 



HARDWARE ERROR 

This record is logged when a hardware error has been de- 
tected, the type of error being indicated by the Trap CC. 
For Sigma 6 and 7, this record is generated as a result of 
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the memory parity interrupt associated with location X'56'. 
For Sigma 9 and Xerox 560 this record is generated as a re- 
suit of the parity error trap associated with location X'4C. 

word 



Type 
X'2D' 

i 2 3 I 4 5 6 7 



Length 
X'OB* 



8 9 10 111 12 13 14 15 



CPU address 



16 17 18 19l20 21 22 23l24 25 26 27 1 26 29 30 3 



word 1 



Relative time 



i 2 3 1 4 5 6 7 I 8 9 10 111 12 13 14 15116 17 18 19 1 20 21 22 23 1 24 25 26 27128 29 30 31 

words 2 and 3 



PSD word 1 
PSD word 2 



i 2 3 I 4 5 6 7 I 8 9 10 111 12 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



words 4 and 5 



Reserved for future use 



FH 2 3 U 5 6 7 I 8 9 10 111 12 13 H 15I16 17 18 19I2O 21 22 23 1 24 25 26 27 1 28 29 30 3 



word 6 



Trap CC 



12 3 14 5 6 7 



8 9 10 111 12 13 14 15 



9T2O 21 22 23 f 



16 17 18 19120 21 22 23124 25 26 27128 29 30 31 



IAP indicates, when set, that a parity error occurred 
due to an indirect address fetch. Words 9 and 10 
will be zero in this case. 

RBP indicates, when set, that a parity error is present 
in the associated R -block registers. (Xerox 560 
only. ) 

ANLZ CC specify the addressing type for the 
effective real address (words 9 and 10). If the 
instruction is an immediate type, these address 
fields will be zero. The ANLZ CC settings 
are: 

Bit Bit 1 Bit 2 Bit 3 









- 





Byte 








- 


1 


Immediate, byte 





1 


- 





Halfword 


1 





- 





Woid 


1 





- 


1 


Immediate, word 


1 


1 


- 





Doubleword 


- 


- 





- 


Direct addressing 


- 


- 


1 


- 


Indirect addressing 



word 7 



Real address of trapped instruction 



i 2 3 I 4 5 6 7 I 8 9 10 1 1 1 12 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



word 8 



Trapped instruction 



1 2 3 I 4 5 6 7 Is 9 10 111 12 13 14 15 1 16 17 18 I9I2O 21 22 23 1 24 25 26 27 1 28 29 30 31 



word 9 



ANLZ CC 



Effective virtual address 



i 2 3 t 4 5 6 718 9 10 11 1 12 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



word 10 



Effective real address 



i 2 3 I 4 5 6 7 I 8 9 10 111 12 13 14 15l 16 17 18 19l 20 21 22 23 1 24 25 26 27l 28 29 30 31 



wher 



FIP indicates, when set, that a parity error occurred 
while fetching the instruction (causing a trap 4C) 
on a Sigma 9 or Xerox 560, or that a memory par- 
ity occurred (causing a machine interrupt using 
location 56) on a Sigma 6 or 7. 



WATCHDOG TIMER 

This record is generated as a result of the instruction watch- 
dog timer runout trap associated with location X'46'. 

wordO 



12 3 



word 1 



Type 
!2EJ 

114 5 6 7 



Length 
X'QB' 

10 11 1 12 13 14 15 



CPU address 



16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



Relative time 



01 2 3 14 5 6 718 9 10 111 12 13 14 151 16 17 18 19120 21 22 23(24 25 26 27128 29 30 31' 



words 2 and 3 



PSD word 1 
PSD word 2 



f 1 2 3 I 4 5 6 Tfe 9 10 11 1 12 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 3 



words 4 and 5 



Reserved for future use 



1 2 3 I 4 5 6 7 Is 9 10 II 1 12 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 
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word 6 



Trap CC 



1 2 3 1 4 5 6 7 18 9 10 ll!l2 13 14 15116 17 18 1»T» 21 22 "iilU 25 26 27T28 29 30 31 

word 7 



Real address of trapped instruction 



Tl 2 3I4 5 6 7 Is 9 10 111 12 13 14 15ll6 17 18 I9I 20 21 22 23I24 25 26 27 1 28 29 30 31 

word 8 



Trapped instruction 



1 2 3 14 5 6 7 18 9 10 1 1 1 12 13 14 15 1 16 17 18 19 1 20 21 22 23T 24 25 26 27128 29 30 31 



I 20 21 22 23 1 2 



word 9 



ANLZ CC 



Effective virtual address 



i 2 3 I 4 5 6 7 I 8 9 10 111 12 13 14 15ll6 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 

word 10 



Effective real address 



1 2 3 14 5 6 7 18 9 10 11 1 12 13 14 151 16 17 18 19120 21 22 23124 25 26 27128 29 30 31 



word 7 



Real address of trapped instruction 



OT 2 3I4 5 6 7U 9 10 111 12 13 14 15ll6 17 18 19I2O 21 22 23l24 25 26 27 1 28 29 30 31 

word 8 



Trapped instruction 



I 4 5 6 7 I 8 9 10 111 12 13 14 15l 



01 2 3 14 5 6 7 18 9 10 11112 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 



word 9 



ANLZ CC 



Effective virtual address 



1 2 3 14 5 6 7 18 9 10 11 1 12 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 



I 20 21 22 23h 



word 10 



Effective real address 



~0 1 2 3 I 4 5 6 ftl 9 10 llll2 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 3 

where FIP, IAP, RBP, and ANLZ CC have the same mean- 
ings as for the hardware error record (X 1 17'). 



where FIP, IAP, RBP, and ANLZ CC have the same mean- 
ing as for the hardware error record (X'17 1 ). 



INSTRUCTION EXCEPTION 

This record is logged when program executions traps to lo- 
cation X'4D' on a Sigma 9 or Xerox 560 due to an instruc- 
tion exception condition. 

word 



Type 
X'2F' 



Length 
X'OB' 



CPU address 



i 1 JM i 4 ?ll » 10 1U12 13 14 is! Id. 17 18 19] 20 21 22 23I24 25 26 27 1 28 29 30 31 

word 1 



Relative time 



i 2 3 U 5 6 7 I 8 9 10 llll2 13 14 15 i 16 17 18 19I2O 21 22 23(24 25 26 27 1 28 29 30 31 



PFI PRIMARY RECORD 

This record is logged when program execution is interrupted 
to location X'56 1 on the Xerox 560 due to a Processor Fault 
Interrupt condition. 

word 



Type 
X'30' 



1 2 314 5 6 7 



Length 
X'02' 



9 10 11112 13 14 15 16 17 18 19120 21 22 23T24 25 26 27728 29 30 31 



1 24* 25 26 27 T 2 



word 1 



Relative time 



1 2 314 5 6 7 I 8 9 10 11112 13 14 15116 17 18 19l20 21 22 23 1 24 25 26 27 1 28 29 30 31 



words 2 and 3 



PSD word 1 
PSD word 2 



i 2 3 I 4 5 6 7 I 8 9 10 111 12 13 14 I5I16 17 18 19I 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



words 4 and 5 




MFI PRIMARY RECORD 

This record is logged as a result of the memory fault in- 
terrupt associated with location X'57' on a Sigma 9 or 
Xerox 560. 

word 



1 2 3T4 5 6 7T8 9 10 11112 13 14 15 1 16 17 18 19120 21 22 23124 25 26 27128 29 30 31 



Type 
X'3T 

1 5 3 U 5 6 7 


Length 
X'Q2' 

8 9 10 11 hi 13 14 15 


1 

CPU address 

16 17 18 19 21 22 23 1 24 25 26 2> 1 28 29 36 31 



word 6 



Trap CC 



12 3 14 5 6 7 



8 9 10 111 12 13 14 15 



; > 



i|i•ii•Mii•;•;^;^i : ;^; : i : :im : : : K : ; : i : •i• : ^^SjK^ 

120 21 22 23124 25 26 27121 



, /f : 



16 17 18 19120 21 22 23T24 25 26 27128 29 30 31 



word 1 



Relative time 



01 2314567189 10 1U12 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 
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XEROX 560 SECONDARY RECORD FOR POLL 
INFORMATION 

This record is logged to record specific information obtained 
by issuing a POLL instruction subsequent to detecting hard- 
ware errors. One record is produced per valid poll status 
received. 

word 



Type 
X'32' 



Length 
X'03' 



CPU address 



i 23 14 56718' 10 1 lT 12 13 14 15 1 16 17 18 »\x 21 22 23^4 25 26 27l26 29 30 31 

word 1 _^_ 



Relative time 



i 2 3 I 4 5 6 7 I 8 9 10 1 1 1 12 13 14 15 1 16 17 IB l?l 20 21 22 23^4 25 26 27 1 ^B 29 30 3V 



word 2 



Unit 
address 



Pol! 
CC 



Unit 

type 



Poll status 



012 Tti 5 6 7TB 9 10 111 12 13 14 15116 17 18 I9|» 2! 22 23 1 24 25 26 27 1 2B 29 30 31 

where unit type has the following meanings: 

1 - Basic Processor 

2 - Memory Interface 

3 - Processor Interface 

4 - Multiplexor IOP 

5 - Rotating Memory Processor 

6 - Not Used 

7 - System Control Processor 



word 3 



Memory status word I 



"o i~2 STT 5 6 7 I B 9 10 111 12 13 14 15! 16 17 18 19! '20 21 22 23I 24 25 26 .?hb '<> X) 



SIGMA 9 MEMORY PARITY SECONDARY RECORD 

This record is logged as a result of the memory fault inter- 
rupt associated with location X'57' or the memory parity 
trap associated with location X'4C on the Sigma 9 or 
Xerox 560. This record follows record type X' 1 7' and 
record type X'3T. 

word 



Type 
X'43' 



Length 
X'05' 



CPU address 



TT 314 5 6 7 I B 9 10 111 12 13 14 15116 17 18 19 1 20 21 22 23 1 2^ 25 26 27 1 28 29 30 3' 



word 1 



n It* 5 6 7 

word 2 



12 3 14 5 6 7 



word 3 



1 2 314 5 6 7 

word 4 



12 3 14 5 6 7 



Relative time 



~9 10 11 ! 12 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27 I 28 



Memory status word 



8 9 10 111 12 13 14 15ll6 17 18 19 1 20 21 22 23 1 24 25 26 27) 28 29 30 3' 



Memory status word 1 

~~9 10 111 12 13 14 I5ll6 17 IB 19I2O 21 22 23 1 24 25 26 27 1 28 7« 30 3 



Memory status word 2 

~9 in 111 12 13 14 15l 16 17 ID 19 1 70 21 22 23 1 24 25 26 27 1 28 29 30 3 



XEROX 560 MEMORY PARITY SECONDARY RECORD 

This record is logged to record specific information returned 
in response to an LMS instruction subsequent to detecting 
hardware errors. 

word 



Type 



X'42' 

~2 3 I 4 5 6 " 



Length 
X'04' 



9 10 11 I 12 13 14 15 



CPU address 



MEMORY PARITY SECONDARY RECORD 

This record is logged to record specific information obtained 
by scanning memory to attempt to isolate locations which 
cannot sustain correct parity. 

word 



16 17 18 19! 20 21 22 23124 25 26 27! 2B 29 30 31 



Type 
X'49' 

i 2 3 I 4 r~6 7 



Length 
X'OB' 



10 11112 13 14 15 



CPU address 



16 17 IB 19 1 20 2' 2? 23 1 24 25 7k 2' 1 28 29 3" 



word 1 



Relative time 

i 2 3 I 4 5 6 7~tl 9 10 111 12 13 14 15 1 16 17 IB 19 1 20 2' 72 23 1 24 25 26 27 1 2R 29 30 3 



/ord 1 



Relative time 



i 2 3 I 4 5 6 7 t 6 9 10 111 12 13 14 15I16 17 18 19 1 20 21 22 23 1 24 25 26 2? 1 2B 29 30 31 



word 2 



B I } 3 I . 



Memory status word 

U 9 16 I l ll 2 13 U Is l llt 17 18 19 l ;0 it 22 h i 84 25 26 }7 | }8 29 36 31 



('ord 2 



Number of bad locations in memory 



1 2 3 14 5 6 7 IB 9 10 111 12 13 14 !5l 16 17 IB 19120 21 22 23124 25 26 27 1 26 29 30 31 
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ford 3 



Logical AND of addresses of the bad locations 



3 i l Ft"* 5 6 T Ti 9 10 111 12 U 14 I5ll6 17 18 !<?! 20 21 22 23 1 24 25 26 2'l?8 29 30 3 

word 4 



Logical OR of addresses of the bad locations 



19120 2' 27 23124 ?5 2ft 2'T2B 29 30 31 



word 5 


















Logicc 

L : t 


1 AND of contents 

•-N - - ■ -717; 1, u-TTT,; 


of the 

1.' \g 19I21 


bad 1 

? 2. 2" 


oca 

^57 ? 


tions 



word 6 




Logical 

1 ? 3(4 56 .' 1 


OR of contents of the bad locations 

8 9 ;o 111:? n 14 15,1 k. 17 IP 19l?fl 2: 22 23I24 25 26 27 1 28 29 30 31 



word 7 



LMS 
CC 

word 8 



Address of lowest location with bad parity 



18 19] 20 21 22 23T74 2.'i 26 27128 T> 3C 31 



Contents of lowest location with bad parity 

c "7*'~ "ti ~'~ Tti . icTiiliy ir™i5li» 1? .» i^bo 2: 22 23I24 2; 25 2/ ! 28 29 io 3 



word 9 




I LMS 
1 CC 


Address of highest location with bad parity 


2 31 


4 5 6 'Is ■> li. nl 12 l. u :•>! !■> 17 18 !»U'. 21 2,2 23l24 26 2a 27" 1 28 29 30 31 



word 10 



Contents of highest location with bad parity 



TT- T~r 5 t i 1 ■ , T tt "9 "|T5 111 12 13 '1 4 hi 16 |7 18 I»t26 S T 22 ii ) U 25 26 g i rt 2. 30 3 



ENQUEUE TABLE OVERFLOW 

This record is logged when an Enqueue CAL has been re- 
jected because there are insufficient unused entries in the 
Enqueue tables. 

word 



Type 
X'50' 



r, --rrrr-r-r 

word 1 



Length 
X'03' 



- ■y.f- ■'ill 1 ■■•■•« 
TTi* r 18 191 



V24 25 2e- 2/-V2 



r 18 19*20 2'. 22 23124 25 2<- 27128 2, 30 31 



Relative time 



F 2 '5" 

v/ord 2 



10 !■ ' 2 13 14 1st 16 17 18 19 , 20 }l }} 23 1 24 25 26 ' W l 28 M 30 ] l' 



User ID 



9 10 ii7i2 13 14 15 



Entry count (in binary) 



16 17 18 19 f 20 21 22 23l24 25 26 27 1 28 29 30 31 



Entry count is the number of entries in the enqueue table 
belonging to the specified user at the time the error log 
entry was made. 



PARTITIONED RESOURCE 

This entry is logged when a resource is partitioned via the 
SYSCO N processor by the operator. 

word 



Type 
X'5T 



Length 
X'03' 



i 2 1 1 4 5 o r n ; 10 nl 12 
word 1 



Model number 



I 2' 2 1 2i 23 1 24 25 2-6 H:3 29 .»• 3 



■b t ;' )l r 



word 2 



Relative time 

71 9 10 111 12 1' 14 islla I" 18 I»!j0 21 2?" 2.1 1 24 25 26 27 1 28 29 30 



I 2 314 5 6 718 9 10 111 12 13 '4 15 



I/O address 



»-7it 



8 19120 71 22 23124 25 26 27128 29 30 31 



/her 



F = for device entry. 
F = 1 for controller entry. 



RETURNED RESOURCE 

This entry is logged when a resource is returned from being 
partitioned via the SYSCON processor by the operator. 

word 



Type 
X'52' 



Length 
X'03' 



Model number 



i 2 3U 5 6 7.8 9 10 111 12 13 14 15116 17 18 19 1 20 21 22 23 1 24 25 26 27I28 29 30 31 



word 1 



Relative time 

i 2 3 I 4 5 6 7 le 9 10 11 1 12 13 14 15 1 16 17 IS 19l 20 21 22 23^4 25 26 27 1 28 29 30 31 



word 2 






F 








I/O address 





1 2 3 I4 


6 7 Is 9 10 111 12 13 14 IS 


16 17 18 w!20 21 22 23l24 25 26 27128 29 30 31 



where 

F = for device entry. 
F = 1 for controller entry. 
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APPENDIX F. XEROX STANDARD OBJECT LANGUAGE 



INTRODUCTION 

GENERAL 

The Xerox standard object language provides a means of 
expressing the output of any Xerox processor in standard 
format. All programs and subprograms in this object format 
can be loaded by the Monitor's relocating loader. ' Such a 
loader is capable of providing the program linkages needed 
to form an executable program in core storage. The object 
language is designed to be both computer-independent and 
medium-independent; i.e., it is applicable to any Xerox 
computer having a 32-bit word length, and the same format 
is used for both cards and paper tape. 



SOURCE CODE TRANSLATION 

Before a program can be executed by the computer, it must 
be translated from symbolic form to binary data words and 
machine instructions. The primary stages of source program 
translation are accomplished by a processor. However, under 
certain circumstances, the processor may not be able to trans- 
late the entire source program directly into machine language 
form. 

If a source program contains symbolic forward references, a 
single-pass processor such as the Xerox Symbol assembler can 
not resolve such references into machine language. This is be- 
cause the machine language value for the referenced symbol 
is not established by a one-pass processor until after the state- 
ment containing the forward reference has been processed. 

A two-pass processor, such as the Xerox Meta-Symbol assem- 
bler, is capable of making "retroactive" changes in the 
object program before the object code is output. Therefore, 
a two-pass processor does not have to output any special 
object codes for forward references. An example of a for- 
ward reference in a Symbol source program is given below. 



EQU $ + 3 



CI, 5 
LI, R 
EQU 
BG 



In this example the operand $ + 3 is not a forward reference 
because the assembler can evaluate it when processing the 
source statement in which it appears. However, the oper- 
and Z in the statement 



CI,5 



is a forward reference because it appears before Z has been 
defined. In processing the statement, the assembler outputs 
the machine-language code for CI,5, assigns a forward ref- 
erence number (e.g., 12) to the symbol Z, and outputs that 
forward reference number. The forward reference number 
and the symbol Z are also retained in the assembler's symbol 
table. 

When the assembler processes the source statement 



LI,R 



it outputs the machine-language code for LI, assigns a for- 
ward reference number (e.g., 18) to the symbol R, outputs 
that number, and again outputs forward reference number 
12 for symbol Z. 

On processing the source statement 

Z EQU 2 

the assembler again outputs symbol Z's forward reference 
number and also outputs the value, which defines symbol Z, 
so that the relocating loader will be able to satisfy refer- 
ences to Z in statements CI, 5 Z and LI, R Z. At this time, 
symbol Z's forward reference number (i.e., 12) may be 
deleted from the assembler's symbol table and the defined 
value of Z equated with the symbol Z (in the symbol table). 
Then, subsequent references to Z, as in source statement 



BG 



would not constitute forward references, since the assembler 
could resolve them immediately by consulting its symbol 
table. 

If a program contains symbolic references to externally 
defined symbols in one or more separately processed subpro- 
grams or library routines, the processor will be unable to 
generate the necessary program linkages. 

An example of an external reference in a Symbol source pro- 
gram is shown below. 



REF 



ALPH 



EQU Z + 1 



LI, 3 ALPH 



Although a discussion of the object language is notdirectly 
pertinent to CP-V, it is included in this manual because it 
applies to some of the processors operating under CP-V. 



When the assembler processes the source statement 
REF ALPH 
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it outputs the symbol ALPH, in symbolic (EBCDIC) form, in 
a declaration specifying that the symbol is an external ref- 
erence. At this time, the assembler also assigns a declara- 
tion name number to the symbol ALPH but does not output 
the number. The symbol and name number are retained in 
the assembler's symbol table. 

After a symbol has been declared an external reference, it 
may appear any number of times in the symbolic subprogram 
in which it was declared. Thus, the use of the symbol 
ALPH in the source statement 



LI, 3 



ALPH 



in the above example, is valid even though ALPH is not 
defined in the subprogram in which it is referenced. 

The relocating loader is able to generate interprogram link- 
ages for any symbol that is declared an external definition 
in the subprogram in which that symbol is defined. Shown 
below is an example of an external definition in a Symbol 
source program. 



DEF 



ALPH 



.for their representation, depending on the type and specific 
I content of each item. A group of 108 bytes, or fewer, com- 
i prises a logical record. A load item may be continued from 
' one logical record to the next. 

The ordered set of logical records that a processor generates 
for a program or subprogram is termed an "object module". 
The end of an object module is indicated by a module-end 
type code followed by the error severity level assigned to 
the module by the processor. 

RECORD CONTROL INFORMATION 

Each record of an object module consists of 4 bytes of con- 
trol information followed by a maximum of 104 bytes of load 
information. That is, each record, with the possible excep- 
tion of the end record, normally consists of 108 bytes of 
information (i.e., 72 card columns). 

The four bytes of control information for each record have 
the form and sequence shown below. 

Byte 



LI, 3 ALPH 



Record Type 


Mode 


Format 




1 1 


1 



ALPH AI,4 X'F2' 

When the assembler processes the source statement 

DEF ALPH 

it outputs the symbol ALPH, in symbolic (EBCDIC) form, in 
a declaration specifying that the symbol is an external defi- 
nition. At this time, the assembler also assigns a declaration 
name number to the symbol ALPH but does not output the 
number. The symbol and name number are retained in the 
assembler's symbol table. 

After a symbol has been declared an external definition it 
may be used (in the subprogram in which it was declared) in 
the same way as any other symbol. Thus, if ALPH is used as 
a forward reference, as in the source statement 



LI, 3 



ALPH 



above, the assembler assigns a forward reference number to 
ALPH, in addition to the declaration name number assigned 
previously. (A symbol may be both a forward reference and 
an external definition.) 

On processing the source statement 

ALPH Al,4 X'F2' 

the assembler outputs the declaration name number of the 
label ALPH (and an expression for its value) and also outputs 
the machine-language code for AI, 4 and the constant X'F2'. 

OBJECT LANGUAGE FORMAT 

An object language program generated by a processor is out- 
put as a string of bytes representing "load items". A load 
item consists of an item type code followed by the specific 
load information pertaining to that item. (The detailed format 
of each type of load item is given later in this appendix.) 
The individual load items require varying numbers of bytes 



Byte 1 



Sequence Number 




Byte 2 



Checksum 




Byte 3 



Record Size 



7 

Record Type specifies whether this record is the last 

record of the module: 

000 means last 

001 means not last 

Mode specifies that the loader is to read binary infor- 

mation. This code is always 11. 

Format specifies object language format. This code is 

always 100. 

Sequence Number is for the first record of the module 
and is incremented by 1 for each record thereafter, 
until it recycles to after reaching 255. 

Checksum is the computed sum of the bytes comprising 

the record. Carries out of the most significant bit 
position of the sum are ignored. 

Record Size is the number of bytes (including the record 

control bytes) comprising the logical record (5 < record 



198 Appendix F 



size ' 103). The recordsize will normally be 108 bytes 
for all records except the last one, which may be fewer. 
Any excess bytes in a physical record are ignored. 

LOAD ITEMS 

Each load item begins with a control byte that indicates the 
item type. In some instances, certain parameters are also 
provided in the load item control byte. In the following dis- 
cussion, load item; are categorized according to their function: 

1. Declarations ideirify to the loader the external and 
contiol section labels that are to be defined in the 
object module being loaded. 

7. Definitions defii? the value of forward references, 

external definitions, the origin of the subprogram being 
loaded, and the storting address (e.g., as provided in 
a Symbol /Me ta -Symbol END directive). 

3. Expression evaluation load items within a definition 
provide the values (such as constants, forward refer- 
ences, etc.) that are to be combined to form the final 
value of the definition. 

4. Loading item' re ; specified information to be stored 
into core merru 

5. Miscellaneous items comprise padding bytes and the 
module-end indicator. 

DECLARATIONS 

In order for the loader to provide the linkage between subpro- 
grams, the processor must generate for each external refer- 
ence or definition a 'oad item, referred to as a "declaration", 
containing the EBCDIC code representation of the symbol 
and the information that the symbol is either an external ref- 
erence or a definition (thus, the loader will have access to 
the actual symbolic name). 

Forward references are always internal references within an 
object module. (External references are never considered 
forward references.) The processor does not generate a dec- 
laration for a forward reference as it does for externals; how- 
ever, it does assign name numbers to the symbols referenced. 



Declaration name numbers (for control sections and external 
labels) and forward reference name numbers apply only within 
the object module in which they are assigned. They have no 
significance in establishing interprogram linkages, since 
external references and definitions are correlated by match- 
ing symbolic names. Hence, name numbers used in any 
expressions in a given object module always refer to symbols 
that have been declared within that module. 



The processor must generate a declaration for each symbol 
that identifies a program section. Each object module pro- 
duced by an assembler is considered to consist of at least 
one control section. If no section is explicitly identified 
in the source program, the assembler assumes it to be a 
standard control section (discussed below). The standard 
control section is always assigned a declaration name 



number of 0. All other control sections (i.e., produced by 
a processor capable of declaring other control sections) are 
assigned declaration name numbers (1, ?., 3, etc.) in the 
order of their appearance in the source program. 

In the load items discussed below, the access code, pp, des- 
ignates the memory protection class that is to be associated 
with the control section. The meaning of this code is given 
below. 



PP 


Memory Protection Feature 


00 


Read, write, or access instructions from. 


01 


Read or access instructions from. 


10 


Read only. 


11 


No access. 



Control sections are always allocated on a doubleword 
boundary. The size specification designates the number of 
bytes to be allocated for the section. 

Declare Standard Control Section 

Byte 



Control byte 















1 

Byte 1 



Access code 




Size (bits 1 through 4) 


P P 









Byte 2 



Size (bits 5 through 12) 



Byte 3 



Size (bits 13 through 20) 







This item declares the standard control section for the object 
module. There may be no more than one standard control 
section in each object module. The origin of the standard 
control section is effectively defined when the first reference 
to the standard control section occurs, although the declara- 
tion item might not occur until much later in the object 
module. 



"Read" means a program can obtain information from the 
protected area; "write" means a program can store informa- 
tion into a protected area; and, "access" means the compu- 
ter can execute instructions stored in the protected area. 
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This capability is required by one-pass processors, since 
the size of a section cannot be determined until all of 
the load information for that section has been generated by 
the processor. 

Declare Nons tandard Control Section 
Byte 



Declare Dummy Section 







Con trol byte 

~0 "0 1 




Byte 1 



Access code I 

p p |"~T 



Siz e (bits 1 through 4) 




Byte 2 






Size (bits 5 through 12) 









Byte 3 




7 




Size (bits 13 through 20) 









This item declares a control section other than standard con- 
trol section (see above). 



Declare Page Boundary Control Section 
Byte 



Control Byte 







1 



1 1 







12 3 4 5 6 7 

Byte 1 



Access code 




Size (bits 1 through 4) 


P P 








1 

Byte 2 



Size (bits 5 through 12) 





Byte 3 




7 




Size (bits 13 through 20) 







7 

This item declares a nonstandard control section beginning 
on a memory page boundary. 



Byte 












- 






Control byte 















1 





1 




Byte 1 



First byte of name number 




Byte 2 



Second byte of name number' 




Byte 3 



Access code 




Size (bits 1 through 4) 


P P 








Byte 4 






Size (bits 5 through 12) 









Byte 5 




7 


Size (bits 13 through 20) 





7 

This item comprises a declaration for a dummy control sec- 
tion. It results in the allocation of the specified dummy 
section, if that section has not been allocated previously 
by another object module. The label that is to be associ- 
ated with the first location of the allocated section must be 
a previously declared external definition name. (Even 
though the source program may not be required to explicitly 
designate the label as an external definition, the processor 
must generate an external definition name declaration for 
that label prior to generating this load item.) 

Declare External Definition Name 
Byte 



Control byte 











1 


1 



Byte 1 


1 


2 3 4 5 


6 


7 


Name length, in bytes (K) 





If the module has fewer than 256 previously assigned name 
numbers, this byte is absent. 
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B Me 2 





First byte of name 











Byte K+1 




7 


Last byte of name 









7 

This item declares a label (in EBCDIC code) that is an exter- 
na! definition within the current object module. The name 
nay not exceed 63 bytes in length. 

Declare Primary External Reference Name 
Byte 



Control byje 




Rvt»» I 



Name sngth (K), in bytes 



Byte 2 



First byte of name 



oyte K + 1 



Last byte of name 



This item declares a symbol (in EBCDIC code) that is a pri- 
mary external reference within the current object module. 
The name may not exceed 63 bytes in length. 

A primary external reference is capable of causing the loader 
to search the system library for a corresponding external 
definition. If a corresponding external definition is not 
found in another load module of the program or in the system 
library, a load error message is output and the job is errored. 

Declare Secondary External Reference Name 



Byte 












Control byte 














1 


1 



Byte 1 




Name length, in bytes (K) 





Byte 2 




First byte of name 







Byte K+1 










Last byte of name 









7 

This item declares a symbol (in EBCDIC code) that is a sec- 
ondary external reference within the current object module. 
The name may not exceed 63 bytes in length. 

A secondary external reference is not capable of causing the 
loader to search the system library for a corresponding exter- 
nal definition. If a corresponding external definition is not 
found in another load module of the program, the job is not 
errored and no error or abnormal message is output. 

Secondary external references often appear in library routines 
that contain optional or alternative subroutines, some of which 
may not be required by the user's program. By the use of pri- 
mary external references in the user's program, the user can 
specify that only those subroutines thatare actually required by 
the current job are tobe loaded. Althoughsecondary external 
references do not cause loading from f he library, they do cause 
linkages to be made between routines that are loaded. 



DEFINITIONS 

When a source language symbol is to be defined (i .e., equa- 
ted with a value), the processor provides for such a value by 
generating an object language expression to be evaluated by 
the loader. Expressions are of variable length, and terminate 
with an expression -end control byte (see "Expression Evalua- 
tion" in this appendix). An expression is evaluated by the ad- 
dition or subtraction of values specified by the expression. 

Since the loader must derive values for the origin and start- 
ing address of a program, these also require definition. 



Ori 



gin 



Byte 


















Control byte 















1 









12 3 4 5 6; 

This item sets the loader's load-location counter to the 
value designated by the expression immediately following 
the origin control byte. This expression must not contain 
any elements that cannot be evaluated by the loader (see 
"Expression Evaluation" which follows). 

Forward Reference Definition 



Byte 












Control byte 








1 
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Byte 1 




_. 


First byj'e of reference number 






Byte 2 



Second bj^te of re ference number 



7 

This item defines the value (expression) for a forward refer- 
ence. The referenced expression is the one immediately 
following byte 2 of this load item, and must not contain 
any elements that cannot be evaluated by the loader (see 
"Expression Evaluation" which follows). 



Forward Reference Definition and Hold 



Byte 














T 


'""" 




Control byte 











1 












1 

Byte 1 



First byte of reference number 




Bvte 2 



Second byte of reference number 







This item defines the value (expression) for a forward refer- 
ence and notifies the loader that this value is to be retained 
in the loader's symbol table until the module end is encoun- 
tered. The referenced expression is the one immediately 
following the name number. It may contain values that have 
not been defined previously, but all such values must be 
available to the loader prior to the module end. 

After generating this load item, the processor need not retain 
the value for the forward reference, since that responsibility 
is then assumed by the loader. However, the processor must 
retain the symbolic name and forward reference number 
assigned to the forward reference (until module end). 



Byte 2 




Second byte of name number 











This item defines the value (expression) for an external 
definition name. The name number refers to a previously 
declared definition name. The referenced expression is 
the one immediately following the name number. 



Define Start 



Byte 









Control byte 













1 1 


1 



This item defines the starting address (expression) to be used 
at the completion of loading. The referenced expression is 
the one immediately following the control byte. 



EXPRESSION EVALUATION 

A processor must generate an object language expression 
whenever it needs to communicate to the loader one of 
the following: 

1. A program load origin. 

2. A program starting address. 

3. An external definition value. 

4. A forward reference value. 

5. A field definition value. 



Such expressions may include sums and differences of con- 
stants, addresses, and external or forward reference values 
that, when defined, will rhemselvesbe constants or addresses. 



External Definition 



Byte 



Control byte 







After initiation of the expression mode, by the use of a con- 
trol byte designating one of the five items described above, 
the value of an expression is expressed as follows: 

1. An address value is represented by an offset from the 
control section base plus the value of the control sec- 
tion base. 



Byte 1 




. 


First byte of name number 





If the module has fewer than 256 previously assigned name 
numbers, this byte is absent. 
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2. The value of a constant is added to the accumulated 
sum by generating an Add Constant (see be low) control 
byte followed by the value, right-justified in four 
bytes. 

The offset from the control section base is given as a 
constant representing the number of units of displace- 
ment from the control section base, at the resolution 
of the address of the item. That is, a word address 
would have its constant portion expressed as a count 
of the number of words offset from the base, while the 
constant portion of a byte address would be expressed 
as the number of bytes offset from the base. 

The control section base value is accumulated by means 
of an Add Value of Declaration (see below)or Subtract 
Value of Declaration load item specifying the desired 
resolution and the declaration number of the control 
section base. The loader adjusts the base value to the 
specified address resolution be fore adding it to the cur- 
rent partial sum for the expression. 

In the case of an absolute address, an Add Absolute 
Section (see below) or Subtract Absolute Section con- 
trol byte must be included in the expression to identify 
the value as an address and to specify its resolution. 



An external definition of forward reference value is 
included in an expression by means of a load item add- 
ing or subtracting the appropriate declaration or for- 
ward reference value. If the value is an address, 
the resolution specified in the control byte is used to 
align the value before adding it to the current partial 
sum for the expression. If the value is a constant, no 
alignment is necessary. 



Change Expression Resolution control byte occurs, then 
the expression resolution is unaffected. 



Note that the expression for a program load origin or 
starting address must resolve to a simple address, and the 
single nonzero resolution counter must have a final count 
of +1 when such expressions are evaluated. 



In converting a byte address to a word address, the two least 
significant bits of the address are truncated. Thus, if the 
resulting word address is later changed back to byte resolu- 
tion, the referenced byte location will then be the first byte 
(byte 0) of the word. 



After an expression has been evaluated, its final value is 
associated with the appropriate load item. 



In the following diagrams of load item formats, RR refers to 
the address resolution code. The meaning of this code is 
given in the table below. 



RR 


Address Resolution 


00 
01 
10 
11 


Byte 

Halfword 
Word 
Doubleword 



Expressions are not evaluated by the loader until all re- 
quired values are available. In evaluating an expression, 
the loader maintains a count of the number of values added 
or subtracted at each of the four possible resolutions. A 
separate counter is used for each resolution, and each 
counter is incremented or decremented by 1 whenever a 
value of the corresponding resolution is added to or sub- 
tracted from the loader's expression accumulator. The final 
accumulated sum is a constant, rather than an address 
value, if the final count in all four counters is equal to 0. 
If the final count in one (and only one) of the four counters 
is equal to +1 or -1, the accumulated sum is a "simple ad- 
ress" having the resolution of the nonzero counter. If 
more than one of the four counters hava a nonzero final 
count, the accumulated sum is termed a "mixed-resolution 
expression" and is treated as a constant rather than an 
address. 



The load item discussed in this appendix, "Expression 
Evaluation", may appear only in expressions. 

Add Constant 



Byte 








Control byte 











1 


1 
Byte 1 


2 3 4 5 


6 


7 


First byte of constant 





The resolution of a simple address may be altered by 
means of a Change Expression Resolution (see below) 
control byte. However, if the current partial sum is 
either a constant or a mixed-resolution value when the 



Byte 2 



Second byte of constant 
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Byte 3 



Third byte of constont 




Byte 4 



Fourth byte of constant 



This item causes the specified four-byte constantto be added 
to the loader's expression accumulator. Negative constants 
are represented in two's complement form. 

Add Absolute Section 



Byte 










Control byte 








110 1 


R 


R 







1 



This item identifies the associated value (expression) as a 
positive absolute address. The address resolution code, RR, 
designates the desired resolution. 

Subtract Absolute Section 



Byte 












Control byte 








1 1 1 





R 


R 







1 



This item identifies the associated value (expression) as a 
negative absolute address. The address resolution code, 
RR, designates the desired resolution. 

Add Value of Declaration 



Byte 














Control byte 








1 








R 


R 



1 

Byte 1 



First byte of name number 




Byte 2 



Second byte of name number 



If the module has fewer than 256 previously assigned name 
numbers, this byte is absent. 



This item causes the value of the specified declaration to be 
added to the loader's expression accumulator. The address 
resolution code, RR, designates the desired resolution, and 
the name number refers to a previously declared definition 
name that is to be associated with the first location of the 
allocated section. 

One such item must appear in each expression for a reloca- 
table address occurring within a control section, adding the 
value of the specified control section declaration (i.e. , 
adding the byte address of the first location of the control 
section). 



Add Value of Forward Reference 



Byte 








Control byte 





10 1 


R 


R 




Byte 1 



First byte of forward reference number 




Byte 2 



Second byte of forward reference number 



7 

This item causes the value of the specified forward reference 
to be added to the loader's expression accumulator. The 
address resolution code, RR, designates the desired resolu- 
tion, and the designated forward reference must not have 
been defined previously. 



Subtract Value of Declaration 



Byte 














Control byte 








1 


1 





R 


R 



1 2 3 4 5 

Byte 1 



First byte of name number 





Byte 2 




7 


Second byte of name number' 





This item causes the value of the specified declaration to 
be subtracted from the loader's expression accumulator. 
The address resolution code, RR, designates the desired 
resolution, and the name number refers to a previously de- 
clared definition name that is to be associated with the 
first location of the allocated section. 
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Subtract Value of Forward Reference 



Symbol Types 



Byte 






i 


Control byte 




to 


1 1 1 R 


R 



Byte 1 


1 2 3 4 5 6 


7 




First byte of forward reference number 







Byte 2 




7 




Second byte of forward reference number 







7 

This item causes the value of the specified forward reference 
to be subtracted from the loader's expression accumulator. 
The address resolution code, RR, designates the desired reso- 
lution, and the designated forward reference must not have 
been defined previously 

Change Expression Resolution 



Byte 

















Control byte 











1 1 





R 


R 







1 



This item causes the address resolution in the expression to 
be changed to that designated by RR. 

Expression End 

Byte 



C ontrol byte 















This item identifies the end of an expression (the value of 
which is contained in the loader's expression accumulator) 



FORMATION OF INTERNAL SYMBOL TABLES 

The three object code control bytes described below are re- 
quired to supply the information necessary in the formation 
of Internal Symbol Tables. 

In the following diagrams of load item formats, Type refers 
to the symbol types supplied by the object language and 
maintained in the symbol table. IR refers to the internal 
resolution code. Type and resolution are meaningful only 
when the value of a symbol is an address. In this case, it 
is highly likely that the processor knows the type of value 
that is in the associated memory location, and the type field 
identifies it. The resolution field indicates the resolution 
of the location counter at the time the symbol was defined. 
The following tables summarize the combinations of value 
and meaning. 



Type 


Meaning of 5-Bit Code 


00000 


Instruction 


00001 


Integer 


00010 


Short floating point 


00011 


Long floating point 


00110 


Hexadecimal (also for packed decimal) 


00111 


EBCDIC text (also for unpacked decimal) 


01001 


Integer array 


01010 


Short floating-point array 


01011 


Long floating-complex array 


01000 


Logical array 


10000 


Undefined symbol 





Internal Resolution 


IR 


Address Resolution 


000 


Byte 


001 


Halfword 


010 


Word 


011 


Doub'eword 


100 


Constant 



Type Information for External Symbol 



Byte 










j Control byte 








1 





1 



Byte 1 



Type field 



IR field 




Byte 2 



Name number 



Byte 


3C 


f requ 


red) 














Name 


number 


(cont 


nued) 





7 

This item provides type information for external symbols. 
The Type and IR fields are defined above. The name 
number field consists of one or two bytes (depending on the 
current declaration count) which specifies the declaration 
number of the external definition. 

Type and EBCDIC for Internal Symbol 



Byte 










Control byte 








1 


1 
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Byfe 1 






Type field 


IR field 




4 5 
Byfe 2 


7 


Lengfh of name (EBCDIC characters) 







Byfe 3 


7 


Firsf byfe of name in EBCDIC 





Byfe n 


7 


Lasf byfe of name in EBCDIC 






Byfe n + 1, . . . 


7 


Expression defining value of infernal symbol 





LOADING 



7 

This i fern supplies fypeand EBCDIC.foran infernal symbol . The 
load ifems for Type and IRare as above . Length of namespeci - 
fies the length of the EBCDIC name in characters . The name, in 
EBCDIC, is specified in the required number of bytes, followed 
by the expression defining the internal symbol. 

EBCDIC for an Undefined Symbol 



Byte 


Control byte 


10 1 1 


12 3 4 5 6 7 
Byte 1 


Length of name (EBCDIC characters) 




7 
Byte 2 


First byte of name in EBCDIC 




7 
Byte n 


Last byte of name in EBCDIC 




7 
Byte n ' 1, n 4 2 


Two bytes of symbol associated forward reference number 





Load Absolute 



Byte 












Control byte 


1 





N 


N 


N 


N 



Byte 1 




First byte to be loaded 


- 



Byte NNNN 




Last byte to be loaded 









This item causes the next NNNN bytes to be loaded abso- 
lutely (NNNN is expressed in natural binary form, except 
that 0000 is interpreted as 16 rather than 0). The load loca- 
tion counter is advanced appropriately. 



Load Relocatable (Long Form) 



Byte 
















Control byte 








1 





1 Q 


C 


R 


R 



1 

Byte 1 



First byte of name number 





Byte 2 




7 


Second byte of name number* 





7 

This item causes a four-byte word (immediately following this 
load item) to be loaded, and relocates the address field 
according to the address resolution code, RR. Control bit 
C designates whether relocation is to be relative to a for- 
ward reference (C = 1) or relative to a declaration (C =0). 
Control bit Q designates whether a 1 -byte (Q = 1) or a 
2-byte (Q = 0) name number follows the control byte of 
this load item. 







This item is used to associate a symbol with a forward reference. 
The length of name and name in EBCDIC are the same as in the 
above item. The last two bytes specify the forward reference 
number with which the above symbol is to be associated. 



If the module has fewer than 256 previously assigned name 
numbers, this byte is absent. 
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If relocation Is to be relative to a forward reference, ftie 
forward reference must not have been defined previously. 
When this load item is encountered by the loader, the load 
location counter can be aligned with a word boundary by 
loading the appropriate number of bytes containing all 
zeros (e.g., by means of a load absolute item). 



Load Relocatable (Short Form) 



Byte 












Control byte 


1 C 


D 


D D 


D 


D 


D 







1 



This item causes a four-byte word (immediately following 
this load item) to be loaded, and relocates the address field 
(word resolution). Control bitC designates whether reloca- 
tion is to be relative to a forward reference (C = 1) or rela- 
tive to a declaration (C = 0). The binary number DDDDDD 
is the forward reference number or declaration number by 
which relocation is to be accomplished. 



If relocation is to be relative to a forward reference, the 
forward reference must not have been defined previously. 
When this load item is encountered by the loader, the load 
location counter must be on a word boundary (see "Load 
Relocatable (Long Form)", above). 



Repeat Load 



Byte 










Control byte 








11 


1 


1 



Byte 1 


1 


2 3 4 5 


6 


7 


First byte of repeat count 





Byte 2 








7 


Second byte of repeat count 





This item causes the loader to repeat (i.e., perform) the 
subsequent load item a specified number of times. The 
repeat count must be greater than 0, and the load item to 
be repeated must follow the repeat load item immediately. 

Define Field 



Byte 














Control byte 











111 



Byte 1 




Field location constant, in bits (K) 






Byte 2 



Field length, in bits (L) 



This item defines a value (expression) to be added to a field 
in previously loaded information. The field is of length L 
(1 < L s 255) and terminates in bit position T, where: 

T = current load bit position -256 +K. 



The field location constant, K, may have any value from 
1 to 255. The expression to be added to the specified 
field is the one immediately following byte 2 of this load 
item. 



MISCELLANEOUS LOAD ITEMS 



Padding 



Byte 












Control byte 

























1 



Padding bytes are ignored by the loader. The object lan- 
guage allows padding as a convenience for processors. 

Module End 

Byte 



Control byte 











1 


1 


1 






Byte 1 


1 


2 


3 4 


5 


6 


7 








Severity level 

















E 


E 


E 


E 







This item identifies the end of the object module. The 
value EEEE is the error severity level assigned to the 
module by the processor. 



OBJECT MODULE EXAMPLE 

The following example shows the correspondence between 
the statements of a Meta-Symbol source program and the 
string of object bytes output for that program by the assem- 
bler. The program, listed below, has no significance other 
than illustrating typical object code sequences. 
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Example 



1 










DEF 


AA,BB,CC 


CC IS UNDEFINED BUT CAUSES NO 
ERROR 


2 










REF 


RZ, RTN 


EXTERNAL REFERENCES DECLARED 


3 


00000 






ALPHA 


CSECT 




DEFINE CONTROL SECTION ALPHA 


4 


000C8 








ORG 


200 


DEFINE ORGIN 


5 


000C8 


22000000 


N 


AA 


LI,CNT 





DEFINES EXTERNAL AA; CNT IS A 
FWD REF 


6 


000C9 


32000000 


N 




LW,R 


RZ 


R IS A FORWARD REFERENCE; 


7 








* 




< 


RZ IS AN EXTERNAL REFERENCE, AS 


8 








* 






w DECLARED IN LINE 2 


9 


000CA 


50000000 


N 


RPT 


AH,R 


KON 


DEFINES RPT; R AND KON ARE 


10 








* 




' 


FORWARD REFERENCES 


11 


000CB 


69200000 


F 




BCS,2 


BB 


BB IS AN EXTERNAL DEFINITION 


12 








* 






USED AS A FORWARD REFERENCE 


13 


OOOCC 


20000001 


N 




AI,CNT 


1 


CNT IS A FORWARD REFERENCE 


14 


OOOCD 


680000CA 






B 


RPT 


RPT IS A BACKWARD REFERENCE 


15 


OOOCE 


68000000 


X 




B 


RTN 


RTN IS AN EXTERNAL REFERENCE 


16 


OOOCF 


0001 


A 


KON 


DATA, 2 


1 


DEFINES KON 


17 




00000003 




R 


EQU 


3 


DEFINES R 


18 




00000004 




CNT 


EQU 


4 


DEFINES CNT 


19 


000 DO 


224FFFFF 


A 


BB 


LI,CNT 


-1 


" DEFINES EXTERNAL BB THAT HAS 


20 








* 




< 


ALSO BEEN USED AS A FORWARD 


21 








* 






^REFERENCE 


22 


000C8 








END 


AA 


END OF PROGRAM 



CONTROL BYTES (In Binary) 
Begin Record Record number: 



00111100 
00000000 
01100011 
01101100 



0000001 



Record type: not last, Mode binary, Format: object language. 
Sequence number 
Checksum: 99 
Record size: 108 



Record control 
► information not 
part of load item 



0302C1C1 (hexadecimal code comprising the load item) "* 

Declare external definition name (2 bytes) Name: AA Declaration number: 1 



0302C2C2 
00000011 Declare external definition name (2 bytes) Name: BB Declaration number: 2 

0302C3C3 
00000011 Declare external definition name (2 bytes) Name: CC Declaration number: 3 ^ 

0502D9E9 
00000101 Declare primary reference name (2 bytes) Name RZ Declaration number: 4 

0503D9E3D5 
00000101 Declare primary reference name (3 bytes) Name: RTN Declaration number: 5 



. Source Line 1 



Source Line 2 
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Begin Record Record number: 



OA010100000320200002 
00001010 "j Define external definition 

Number 1 
00000001 „ Add constant: 800 X'320' 
00100000 Add value of declaration (byte resolution) 

Number 
00000010 J Expression end 

040100000320200002 
00000100 1 Origin 
00000001 Add constant: 800 X'320' 

00100000 " Add value of declaration (byte resolution) 

Number 
00000010 J Expression end 

4422000000 
01000100 Load absolute the following 4 bytes: X'22000000' 

07EB0426000002 
00000111 ^ Define field 

Field location constant: 235 bits 

Field length: 4 bits 

Add the following expression to the above field: 
00100110 Add value of forward reference (word resolution) 

Number 
00000010 J Expression end 

8432000000 
10000100 Load relocatable (short form). Relocate address field (word resolution) 

Relative to declaration number 4 
The following 4 bytes: X'32000000' 

07EB0426000602 
00000111 Define field 

Field location constant: 235 bits 

Field length: 4 bits 

Add the following expression to the above field: 
00100110 Add value of forward reference (word resolution) 

Number 6 
00000010 Expression end 

CC50000000 
11001100 Load relocatable (short form). Relocate address field (word resolution) 

Relative to forward reference number 12 
The following 4 bytes: X'50000000' 

07EB0426000602 
00000111 Define field 

Field location constant: 235 bits 

Field length: 4 bits 

Add the following expression to the above field: 
00100110 Add value of forward reference (word resolution) 

Number 6 
00000010 Expression end 



► Source Line 5 



' Source Line 4 



*■ Source Line 5 



► Source Line 6 



► Source Line 9 



No object code is generated for source lines 3 (define control section) or 4 (define origin) at the time they are encountered. 
The control section is declared at the end of the program after Symbol has determined the number of bytes the program requires. 
The origin definition is generated prior to the first instruction. 
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Begin Record Record number: 

D269200000 
11010010 Load relocatable (short form). Relocate address field (word resolution) 

Relative to forward reference number 18 
The following 4 bytes: X'69200000' 

4420000001 
01000100 Load absolute the following 4 bytes: X'20000001' 

07EB0426000002 
00000111 Define field 

Field location constant: 235 bits 

Field length: 4 bits 

Add the following expression to the above field: 
00100110 Add value of forward reference (word resolution) 

Number 
00000010 Expression end 

80680000CA 
10000000 Load relocatable (short form). Relocate address field (word resolution) 

Relative to declaration number 
The following 4 bytes: X'680000CA' 

8568000000 
10000101 Load relocatable (short form). Relocate address field (word resolution) 

Relative to declaration number 5 
The following 4 bytes: X'68000000' 

08 
00001000 Define forward reference (continued in record 1) 



} 



Source Line 1 1 



Source Line 13 



} 
} 



Source Line 14 



Source Line 15 



Source Line 16 



Begin Record Record number: 1 



00011100 Record type: last, Mode: binary, Format: object language. 

0000000 1 Sequence number 1 

11101100 Checksum: 236 

01010001 Record size: 81 

OOOC010000033C200002 (continued from record 0) 

Number 12 
00000001 Add constant: 828 X'33C 

00100000 Add value of declaration (byte resolution) 

Number 
00000010 Expression end 

42001 
01000010 Load absolute the following 2 bytes: X'OOOT 

080006010000000302 
00001000 Define forward reference 

Number 6 
00000001 Add constant: 3 X'3' 

00000010 Expression end 

080000010000000402 
00001000 Define forward reference 

Number 
00000001 Add constant: 4 X'4' 

00000010 Expression end 



Record Control 
Information 



Source Line 16 



Source Line 17 



Source Line 18 



210 Appendix F 



Begin Record Record number: 1 



OF00024100 
00001111 Repeat load 

Repeat count. 2 
01000001 Load absolute the following 1 bytes: X'00' 

0800 1 20 1 00000340200002 
00001000 Define forward reference 

Number 18 
00000001 Add constant: 832 X'340' 

Add value of declaration (byte resolution) 

Number 
00000010 Expression end 

OA020 1 00000340200002 

00001010 Define external definition 
Number 2 

00000001 Add constant: 832 X'340' 

00100000 Add value of declaration (byte resolution) 

Number 
00000010 Expression end 

44224FFFFF 
01000100 Load absolute the following 4 bytes: X'224FFFFF' 

0D0 100000320200002 
00001101 Define start 

00000001 Add constant: 800 X'320' 

00100000 Add value of declaration (byte resolution) 

Number 
00000010 Expression end 

0B000344 

00001011 Declare standard control section declaration number* 
Access code: Full access. Size 836 X'344' 



Advance to Word 
Boundary 



Source Line 19 



Source Line 22 



0E00 
00001110 Module end 

Severity level: X'0' 



A table summarizing control byte codes for object language load items is given below. 



Object Code Control Byte 


Type of Load Item 













Padding 










1 


Add constant 







1 





Expression end 







1 


1 


Declare external definition name 




1 








Origin 




1 





1 


Declare primary reference name 




1 


1 





Declare secondary reference name 




1 


1 


1 


Define field 




10 








Define forward reference 




10 





1 


Declare dummy section 




10 


1 





Define external definition 
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Object 


Code Control 


Byte 






Type of Load Item 
















1 


1 


Declare standard control section 















1 








Declare nonstandard control section 















1 





1 


Define start 















1 


1 





Module end 















1 


1 


1 


Repeat load 
























Define forward reference and hold 





















1 


Provide type information for external symbol 


















1 





Provide type and EBCDIC for internal symbol 


















1 


1 


EBCDIC and forward reference number for undefined 


symbol 










1 


1 


1 





Declare page boundary control section 


















R 


R 


Add value of declaration 















1 


R 


R 


Add value of forward reference 












1 





R 


R 


Subtract value of declaration 












1 


1 


R 


R 


Subtract value of forward reference 









1 








R 


R 


Change expression resolution 









1 





1 


R 


R 


Add absolute section 









1 


1 





R 


R 


Subtract absolute section 




1 








N 


N 


N 


N 


Load absolute 




1 





1 


Q 


C 


R 


R 


Load relocatable (long form) 




1 c 


D 


D 


D 


D 


D 


D 


Load relocatable (short form) 
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APPENDIX & XEROX STANDARD COMPRESSED LANGUAGE 



The Xerox standard compressed language is used to represent 
source EBCDIC information in a highly compressed form. 

Meta-Symbol (along with several of the utility programs) 
accepts this form as input or output, will accept updates to 
the compressed input and will regenerate source when re- 
quested. No information is destroyed in the compression or 
decompression. 

Records may not exceed 108 bytes in length. Compressed 
records are punched in the binary mode when represented 
on card media. Therefore, on cards, columns 73 through 
80 are not used and are available for comment or identifi- 
cation information. 

The first four bytes of each record are for checking purposes. 
They are as fol lows: 

Byte 1 Identification (00L 1 1 000) L = 1 for each record 
except the last record, in which case L=0. 



Byte 2 Sequence number (0 to 255 and recycles). 

Byte 3 Checksum which is the least significant 8 bits 
of the sum of all bytes in the record except 
the checksum byte itself. Carries out of the 
most significant bit are ignored. If the 
checksum byte is all l's, do not checksum 
the record. 

Byte 4 Number of bytes comprising record including 
the checking bytes (^ 108) 

The rest of the record consists of a string of 6-bit and 8-bit 
items. Any partial item at the end of a record is ignored. 

The following six-bit items (decimal number assigned) com- 
prise the string control: 



Item 


Function 


Item 


Function 





Ignore 


32 


O 


1 


Not currently assigned 


33 


P 


2 


End of line 


34 


Q 


3 


End of file 


35 


R 


4 


Use 8-bit character that follows 


36 


S 


5 


Usen+1 blanks (next 6-bit item is n) 


37 


T 


6 


Usen+65 blanks (next 6-bit item is n) 


38 


U 


7 


Blank 


39 


V 


8 





40 


W 


9 


1 


41 


X 


10 


2 


42 


Y 


11 


3 


43 


Z 


12 


4 


44 


. 


13 


5 


45 


< 


14 


6 


46 


( 


15 


7 


47 


+ 


16 


8 


48 


1 


17 


9 


49 


& 


18 


A 


50 


$ 


19 


B 


51 


* 


20 


C 


52 


) 


21 


D 


53 


/ 


22 


E 


54 


-n 


23 


F 


55 


- 


24 


G 


56 


/ 


25 


H 


57 


/ 


26 


I 


58 


% 


27 


J 


59 


i— i 


28 


K 


60 


> 


29 


L 


61 


; 


30 


M 


62 


i 


31 


N 


63 


= 


f Eight-bit c 


laracters are in uncompressed EBCDIC format (e 


.g., !@ # ?). 
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APPENDIX H. XEROX STANDARD SYMBOLS, CODES AND CORRESPONDENCES 



XEROX STANDARD SYMBOLS AND CODES 

The symbols listed here include two types: graphic symbols 
and control characters. Graphic symbols are displayable 
and printable; control characters are not. Hybrids are SP 
(the symbol for a blank space), and DEL (the delete code) 
which is not considered a control command. 



Two types of code are also shown: (l)the 8-bit Xerox Stan- 
dard Computer Code, i.e., the Xerox Extended Binary- 
Coded-Interchange Code (EBCDIC); and (2) the 7-bit Amer- 
ican National Standard Code for information Interchange 
(ANSCII), i.e., the Xerox Standard Communication Code. 



XEROX STANDARD CHARACTER SETS 

1 . EBCDIC 

57-character set: uppercase letters, numerals, space, 
and &-/.<>() + I $ * :; , 

% # @ ' = 

63-character set: same as above plus £ ! ? 



2. ANSCII 

64-character set: uppercase letters, numerals, space, 
and !"$%&'()*+,-./ \ 



= < > ? 



_ [] 



95-character set: same as above plus lowercase letters 

and \ \ | ~ * 

CONTROL CODES 

In addition to the standard character sets listed above, the 
Xerox symbol repertoire includes 37 control codes and the 
hybrid code DEL (hybrid code SP is considered part of all 
character sets). These are listed in the table titled CP-V 
Symbol -Code Correspondences. 

SPECIAL CODE PROPERTIES 

The following two properties of all Xerox standard codes 
will be retained for future standard code extensions: 

1. All control codes, and only the control codes, have 
their two high-order bits equal to "00". DEL is not 
considered a control code. 



89-character set: same as 63-character set plus lower- 
case letters 



2. No two graphic EBCDIC codes have their seven low- 
order bits equal. 



214 Appendix H 



Table H-l. CP-V 8-Bit Computer Codes (EBCDIC) 









Most Significant Digits 




Hexadecimal 





1 


2 


3 


4 


5 


6 


7 


8 


9 


A 


B 


C 


D 


E 


F 






Binary 


0000 


0001 


0010 


0011 


0100 


0101 


0110 


0111 


1000 


1001 


1010 


1011 


1100 


1101 


1110 


mi 


VI 

s 

C 
O 

o 

u- 

'c 
.5? 
in 

8 
o> 

_i 





0000 


NUL 


DLE 


LF 
only 


ESC 
F 


SP 


& 


- 


A 










SP 




- 





1 


0001 


SOH 


X-ON 


FS 


CAN 


7 




/ 


♦ • 


a 


i 




\' 


A 


J 




i 


2 


0010 


STX 


DC2 


GS 


ESC 
X 


x 


' ' """" 


r 


*"' 


b 


k 


s 


(' 


B 


K 


S 


2 


3 


0011 


ETX 


X-OFF 


RS 


ESC 
P 











c 


i 


r 


(' 


C 


L 


T 


3 


4 


0100 


EOT 


DC4 


US 


ESC 
U 


t 




•...*. .. 


*& 


d 


m 


u 


[' 


D 


M 


U 


4 


5 


0101 


HT 


LF 
NL 


EM 


ESC 

( 


c 


T 

... 


iiiiftil! 




e 


n 


V 


]' 


E 


N 


V 


5 


6 


0110 


ACK 


8 
SYN 


/ 


ESC 

) 




o 


u) 


> 


f 


o 


w 




F 


O 


W 


6 


7 


0111 


BEL 


ETB 


A 


ESC 
T 






9 




g 


P 


X 




G 


P 


X 


7 


8 


1000 


EOM 
BS 


CAN 


= 


ESC 
S 


& 








h 


q 


y 




H 


Q 


Y 


8 


9 


1001 


ENQ 


EM 


CR 
only 


ESC 
E 


i 






V 


i 


r 


z 




I 


R 


Z 


9 


A 


1010 


NAK 


SUB 


EOT 


ESC 
C 


2 


! 


^ 1 


• 










7 






X 


B 


1011 


VT 


ESC 


BS 


ESC 
LF 


. 


$ 


/ 


§ 










h^ 




♦ 


C 


1100 


FF 


FS 


) 


X-ON 


< 


* 


% 


@ 








[• 








&*■ 


D 


1101 


CR 


GS 


HT 


X-OFF 


( 


) 




1 








] 8 








— 


E 


1110 


SO 


RS 


LF 
only 


ESC 
R 


+ 


t 


> 


= 








LostB 
Data 




^mj|11I 




F 


mi 


SI 


US 


SUB 


ESC 
CR 


I 2 


2 

— i 


? 


" 






•l 


-, 8 


£*#* , v.-;i..:i ::l_l^, 


DEL 



T 



4,7 



Notes: 



1 The characters^ \ { \ [] are ANSCII characters that do not appear in any of the Xerox EBCDIC-based 
character sets, though they are shown in the EBCDIC table. 

2 The characters / I — i appear in the Xerox 63- and 89-character EBCDIC sets but not in either of the Xerox 
ANSCII-based sets. However, Xerox software translates the characters fi I —\ into ANSCII characters as 
follows: 

EBCDIC = ANSCII 



X (6-0) 
! (7-12) 



-i ~ (7-14) 

3 The EBCDIC control codes in columns and 1 and their binary representation are exactly the same as those 
in the ANSCII table, except for two interchanges: LF/NL with NAK, and HT with ENQ. 

4 Characters enclosed in heavy lines are included only in the Xerox standard 63- and 89-character EBCDIC sets. 

5 These characters are included only in the Xerox standard 89-character EBCDIC set. 

6 The EBCDIC codes in column 3 are used by COC to perform special functions. The EBCDIC codes in 
column 2 and positions AF and BC through BF are used by COC for output only. 

1 APL characters are assigned EBCDIC values that fall within the shaded area of the CP-V code set. These 
assignments are for APL internal use and are only reflected in 2741 -APL translation tables. 

8 Placing a SYN code as the last position of a nontransparent message will prevent the transmission of the SYN 
and the normal message appendage of the CR/LF pair. This allows a user to continue writing more than one 
message on the same line without affecting the carrier position. The EBCDIC SYN code is translated to an 
idle (IL) on output to 2741 terminals. 
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Table H-2. CP-V 7-Bit Communication Codes (ANSCII) 









Most Significant Digits 




Deci 
(row 

1 


mal 

s) (col's.)-* 





1 


2 


3 


4 


5 


6 


7 




Binary 


xOOO 


xOOl 


xOlO 


xOll 


xlOO 


xlOl 


xllO 


xlll 


"a> 

a 

c 
o 
o 

u- 

"c 
,g> 
In 

VI 

O 
O 
—1 





0000 


NUL 


DLE 


SP 





@ 


P 


\ 


P 


1 


0001 


SOH 


DC1 


5 
! 


1 


A 


Q 


a 


q 


2 


0010 


STX 


DC2 


" 


2 


B 


R 


b 


r 


3 


0011 


ETX 


DC3 


# 


3 


C 


S 


c 


s 


4 


0100 


EOT 


DC4 


$ 


4 


D 


T 


d 


t 


5 


0101 


ENQ 


NAK 


% 


5 


E 


U 


e 


u 


6 


0110 


ACK 


SYN 


& 


6 


F 


V 


f 


V 


7 


0111 


BEL 


ETB 


1 


7 


G 


W 


9 


w 


8 


1000 


BS 


CAN 


( 


8 


H 


X 


h 


X 


9 


1001 


HT 


EM 


) 


9 


I 


Y 


i 


y 


10 


1010 


LF 
NL 


SUB 


* 


: 


J 


Z 


J 


z 


11 


1011 


VT 


ESC 


+ 


r 


K 


V 


k 


{ 


12 


1100 


FF 


FS 


/ 


< 


L 


\ 


1 


1 
1 


13 


1101 


CR 


GS 


- 


= 


M 


V 


m 


I 4 


14 


1101 


SO 


RS 


. 


> 


N 


4^5 


n 


4 


15 


mi 


SI 


US 


/ 


? 


O 


4 


o 


DEL 



Notes: 



1 Most significant bit, added for 8-bit format, is either or an even-parity bit for the remaining 7 bits. 

2 Columns 0-1 are control codes. 

3 Columns 2-5 correspond to the Xerox 64-character ANSCII set. 
Columns 2-7 correspond to the Xerox 95-character ANSCII set. 

4 On many current teletypes, the symbol 

~ is t (5-14). 
_ is — (5-15) 

- is ESC or ALTMODE control (7-14) 
} is ESC or ALTMODE control (7-13) 

and none of the symbols appearing in columns 6-7 are provided. Except for the four symbol differences 
noted above, therefore, such teletypes provide all the characters in the Xerox 64-character ANSCII set. 
(The Xerox 7015 Remote Keyboard Printer provides the 64-character ANSCII set also, but prints ^ as A. 
It also interprets the [ ] characters as I — i . ) 

5 On the Xerox 7670 Remote Batch Terminal, the symbol 

! is I (2-1) ] is ! (5-13) 

[ is £ (5-11) ~is-- (5-14) 

and none of the symbols appearing in columns 6-7 are provided. Except for the four symbol differences noted 
above, therefore, this terminal provides all the characters in the Xerox 64-character ANSCII set. 
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Table H-3. CP-V Symbol-Code Correspondences 



EBCDIC* 


Symbol 


Card Code 


ANSCII" 


Meaning 


Remarks 


Hex. 


Dec. 


00 





NUL 


12-0-9-8-1 


0-0 


null 


00 through IF are control codes. 


01 


1 


SOH 


12-9-1 


0-1 


start of header 


On 2741 terminals, SOH is PRE. 


02 


2 


STX 


12-9-2 


0-2 


start of text 


On 2741 terminals, STX is BY. 


03 


3 


ETX 


12-9-3 


0-3 


end of text 


On 2741 terminals, ETX is RES. 


04 


4 


EOT 


12-9-4 


0-4 


end of transmission 




05 


5 


HT 


12-9-5 


0-9 


horizontal tab 


00, 06, 07, 09-OB, and 0E-0F 


06 


6 


ACK 


12-9-6 


0-6 


acknowledge (positive) 


are idles for 2741 terminals. 


07 


7 


BEL 


12-9-7 


0-7 


bell 




08 


8 


BS or EOM 


12-9-8 


0-8 


backspace or end of message 


EOM is used only on Xerox Keyboard/ 


09 


9 


ENQ 


12-9-8-1 


0-5 


enquiry 


Printers Models 7012, 7020, 8091, 


0A 


10 


NAK 


12-9-8-2 


1-5 


negative acknowledge 


and 8092. 


0B 


11 


VT 


12-9-8-3 


0-11 


vertical tab 




OC 


12 


FF 


12-9-8-4 


0-12 


form feed 




0D 


13 


CR 


12-9-8-5 


0-13 


carriage return 


CR outputs CR and LF. 


OE 


14 


SO 


12-9-8-6 


0-14 


shift out 




OF 


15 


SI 


12-9-8-7 


0-15 


shift in 




10 


16 


DLE 


12-11-9-8-1 


1-0 


data link escape 




11 


17 


DC1 


11-9-1 


1-1 


device control 1 


On Teletype terminals, DC1 is X-ON. 


12 


18 


DC2 


11-9-2 


1-2 


device control 2 


On 2741 terminals, DC2 is PN. 


13 


19 


DC3 


11-9-3 


1-3 


device control 3 


DC3 is RS on 2741s and X-OFF on 


14 


20 


DC4 


11-9-4 


1-4 


device control 4 


Teletypes. 


15 


21 


LF or NL 


11-9-5 


0-10 


line feed or new line 


On 2741 terminals, DC4 is PF. 


16 


22 


SYN 


11-9-6 


1-6 


sync 


LF outputs CR and LF. 


17 


23 


ETB 


11-9-7 


1-7 


end of transmission block 


On 2741 terminals, ETB is EOB. 


18 


24 


CAN 


11-9-8 


1-8 


cancel 




19 


25 


EM 


11-9-8-1 


1-9 


end of medium 




1A 


26 


SUB 


11-9-8-2 


1-10 


substitute 


Replaces characters with parity error. 


IB 


27 


ESC 


11-9-8-3 


1-11 


escape 




1C 


28 


FS 


11-9-8-4 


1-12 


file separator 




ID 


29 


GS 


11-9-8-5 


1-13 


group separator 


10, 11, 16, 18, 19, and IB-IE are 


IE 


30 


RS 


11-9-8-6 


1-14 


record separator 


idles for 2741 terminals. 


IF 


31 


US 


H-9-8-7 


1-15 


unit separator 




20 


32 


LF only 


H-0-9-8-1 


1-5 


line feed only 


20 through 2F are used by COC for 


21 


33 


FS 


0-9-1 


1-12 




output only. These codes are 


22 


34 


GS 


0-9-2 


1-13 




duplicates of the label entries 


23 


35 


RS 


0-9-3 


1-14 




that caused activation. The 


24 


36 


US 


0-9-4 


1-15 




20-2F entries output a single code 


25 


37 


EM 


0-9-5 


1-9 




only and are not affected by any 


26 


38 


/ 


0-9-6 


2-15 




special COC functional processing. 


27 


39 


t 


0-9-7 


5-14 






28 


40 


= 


0-9-8 


3-13 






29 


41 


CR only 


0-9-8-1 


0-13 


carriage return only 




2A 


42 


EOT 


0-9-8-2 


0-4 






2B 


43 


BS 


0-9-8-3 


0-8 






2C 


44 


) 


0-9-8-4 


2-9 






2D 


45 


HT 


0-9-8-5 


0-9 


tab code only 




2E 


46 


LF only 


0-9-8-6 


1-5 


line feed only 




2F 


47 


SUB 


0-9-8-7 


1-10 






30 


48 


ESCF 


12-11-0-9-8-1 




end of file 


30 through 3F cause COC to perform 


31 


49 


CANCEL 


9-1 




delete all input and output 


special functions. 


32 


50 


ESCX 


9-2 




delete input line 




33 


51 


ESCP 


9-3 




toggle half-duplex paper tape made 




34 


52 


ESCU 


9-4 




toggle restrict upper case 




35 


53 


ESC ( 


9-5 




upper case shift 




36 


54 


ESC) 


9-6 




lower case shift 




37 


55 


ESCT 


9-7 




toggle tab simulation mode 




38 


56 


ESCS 


9-8 




toggle space insertion mode 




39 


57 


ESCE 


9-8-1 




toggle echo mode 




3A 


58 


ESCC 


9-8-2 




toggle tab relative mode 




3B 


59 


ESC LF 


9-8-3 




line continuation 


3B toggles the backspace edit mode 


3C 


60 


X-ON 


9-8-4 




start paper tape 


for 2741 terminals. 


3D 


61 


X-OFF 


9-8-5 




stop paper tape 




3E 


62 


ESCR 


9-8-6 




retype 




3F 


63 


ESCCR 


9-8-7 




line continuation 




Hexadecima 


and decimal 


notation. 








Decimal not 


otion (column- 


tow). 
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Table H-3. CP-V Symbol-Code Correspondences (conr.) 



EBCDIC 1 


Symbol 


Card Code 


ANSCH" 


Meaning 


Remarks 


Hex. 


Dec. 


40 


64 


SP 


blank 


2-0 


blank 




41 


65 




12-0-9-1 






41, 43, 46, and 47 are unassigned. 


42 


66 


1 


12-0-9-2 




decode 




43 


67 




12-0-9-3 








44 


68 


L 


12-0-9-4 




minimum 


42, 44, 45, 48, and 49 are APL 


45 


69 


c 


12-0-9-5 




epsi Ion 


characters for 2741 APL use only. 


46 


70 




12-0-9-6 








47 


71 




12-0-9-7 








48 


72 


A 


12-0-9-8 




delta 




49 


73 


I 


12-8-1 




index 




4A 


74 


/or ' 


12-8-2 


6-0 


cent or accent grave 


Accent grave used for left single 


4B 


75 




12-8-3 


2-14 


period 


quote. On Model 7670, * not 


4C 


76 


< 


12-8-4 


3-12 


less than 


available, and / = ANSCII 5-11. 


4D 


77 


( 


12-8-5 


2-8 


left parenthesis 


On 2741 APL, / is c (subset). 


4E 


78 


+ 


12-8-6 


2-11 


plus 




4F 


79 


1 or i 


12-8-7 


7-12 


vertical bar or broken bar 


On Model 7670, | not available, 
and l=ANSCH2-l. 


50 


80 


& 


12 


2-6 


ampersand 


On 2741 APL, & is PI (intersection). 


51 


81 




12-11-9-1 






51, 52, 54, 57, 58, and 59 are 


52 


82 




12-11-9-2 






unassigned. 


53 


83 


D 


12-11-9-3 




quad 


53, 55, and 56 are APL characters 


54 


84 




12-11-9-4 






for 2741 APL use only. 


55 


85 


T 


12-11-9-5 




encode 




56 


86 


O 


12-11-9-6 




circular 




57 


87 




12-11-9-7 








58 


88 




12-11-9-8 








59 


89 




11-8-1 








5A 


90 


I 


11-8-2 


2-1 


exclamation point 


On Model 7670, I is 1 . On 2741 


5B 


91 


$ 


11-8-3 


2-4 


dollars 


APL, 1 is o (degree). On 2741 


5C 


92 


* 


11-8-4 


2-10 


asterisk 


APL, $ is U (union). 


5D 


93 


) 


11-8-5 


2-9 


right parenthesis 




5E 


94 


; 


11-8-6 


3-11 


semicolon 




5F 


95 


~or— I 


11-8-7 


7-14 


tilde or logical not 


On Model 7670, ~ is not available, 
and— 1= ANSCII 5-14. 


60 


96 


_ 


11 


2-13 


minus, dash, hyphen 




61 


97 


/ 


0-1 


2-15 


slash 




62 


98 


r 


11-0-9-2 




maximum 


62, 64, 66, and 67 are APL characters 


63 


99 




11-0-9-3 






for 2741 APL use only. 


64 


100 


i 


11-0-9-4 




down arrow 




65 


101 




11-0-9-5 








66 


102 


u 


11-0-9-6 




omega 


63, 65, 68, and 69 are unassigned. 


67 


103 


3 


11-0-9-7 




superset 




68 


104 




11-0-9-8 








69 


105 




0-8-1 








6A 


106 


/S 


12-11 


5-14 


circumflex 


On Model 7670 ~ is — i. On Model 


6B 


107 


t 


0-8-3 


2-12 


comma 


7015 ~ is A (caret). On 2741 APL, 


6C 


108 


% 


0-8-4 


2-5 


percent 


'Ns t . On 2741 APL, % is P. 


6D 


109 


- 


0-8-5 


5-15 


underline 


Underline is sometimes called "break 


6E 


110 


> 


0-8-6 


3-14 


greater than 


character"; may be printed along 


6F 


111 


? 


0-8-7 


3-15 


question mark 


bottom of character line. 


70 


112 


A 


12-11-0 




APL 


70-72, 74, 76, and 79 qre APL 


71 


113 




12-11-0-9-1 




APL quote mark 


characters for 2741 APL use only. 


72 


114 


- 


12-11-0-9-2 




overscore 




73 


115 




12-11-0-9-3 








74 


116 


< 


12-11-0-9-4 




less than or equal 


73, 75, 77, and 78 are unassigned. 


75 


117 




12-11-0-9-5 








76 


118 


> 


12-11-0-9-6 




greater than or equal 




77 


119 




12-11-0-9-7 








78 


120 




12-11-0-9-8 








79 


121 


V 


8-1 




down delta 




7A 


122 




8-2 


3-10 


colon 




7B 


123 


# 


8-3 


2-3 


number 




7C 


124 


@ 


8-4 


4-0 


at 




7D 


125 


' 


8-5 


2-7 


apostrophe (right single quote) 




7E 


126 


= 


8-6 


3-13 


equals 




7F 


127 


" 


8-7 


2-2 


quotation mark 




*Hex 


adecima 


and dec! ma 


notation. 








Dec 


imal note 


it! on (column 


-row). 
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Table H-3. CP-V Symbol-Code Correspondences (cont.) 



EBCDIC* 


Symbol 


Card Code 


ANSCll" 


Meaning 


Remarks 


Hex. 


Dec. 


80 
81 
82 
83 
84 
85 
86 
87 
88 
89 
8A 
8B 
8C 
8D 
8E 
8F 


128 
129 
130 
131 
132 
133 
134 
135 
136 
137 
138 
139 
140 
141 
142 
143 


a 
b 
c 
d 

e 
f 

g 
h 

i 


12-0-8-1 

12-0-1 

12-0-2 

12-0-3 

12-0-4 

12-0-5 

12-0-6 

12-0-7 

12-0-8 

12-0-9 

12-0-8-2 

12-0-8-3 

12-0-8-4 

12-0-8-5 

12-0-8-6 

12-0-8-7 


6-1 
6-2 
6-3 
6-4 
6-5 
6-6 
6-7 
6-8 
6-9 




80 is unassigned. 

81-89, 91-99, A2-A9 comprise the 
lowercase alphabet. Available 
only in Xerox standard 89- and 95- 
character sets. 

8A through 90 are unassigned. 


90 
91 
92 
93 
94 
95 
96 
97 
98 
99 
9A 
9B 
9C 
9D 
9E 
9F 


144 
145 
146 
147 
148 
149 
150 
151 
152 
153 
154 
155 
156 
157 
158 
159 


J 

k 

1 

m 

n 

o 

P 

q 

r 


12-11-8-1 

12-11-1 

12-11-2 

12-11-3 

12-11-4 

12-11-5 

12-11-6 

12-11-7 

12-11-8 

12-11-9 

12-11-8-2 

12-11-8-3 

12-H-8-4 

12-11-8-5 

12-11-8-6 

12-11-8-7 


6-10 

6-11 

6-12 

6-13 

6-14 

6-15 

7-0 

7-1 

7-2 




9A through Al are unassigned. 


A0 
A1 
A2 
A3 
A4 
A5 
A6 
A7 
A8 
A9 
AA 
AB 
AC 
AD 
AE 
AF 


160 
161 
162 
163 
164 
165 
166 
167 
168 
169 
170 
171 
172 
173 
174 
175 


s 

t 
u 

V 

w 

X 

y 

z 

1 


11-0-8-1 

11-0-1 

11-0-2 

11-0-3 

11-0-4 

11-0-5 

11-0-6 

11-0-7 

11-0-8 

11-0-9 

11-0-8-2 

11-0-8-3 

11-0-8-4 

11-0-8-5 

11-0-8-6 

11-0-8-7 


7-3 
7-4 
7-5 
7-6 
7-7 
7-8 
7-9 
7-10 


logical and 


AA through AE are unassigned. 

AF is used by COC for output of 
an ANSCII 7-12 code only. 


BO 
Bl 
B2 
B3 
B4 
B5 
B6 
B7 
B8 
B9 
BA 
BB 
BC 
BD 
BE 
BF 


176 
177 
178 
179 
180 
181 
182 
183 
184 
185 
186 
187 
188 
189 
190 
191 


\ 

1 

[ 
] 

[ 
] 

lost data 

— 1 


12-11-0-8-1 

12-11-0-1 

12-11-0-2 

12-11-0-3 

12-11-0-4 

12-11-0-5 

12-11-0-6 

12-11-0-7 

12-11-0-8 

12-11-0-9 

12-11-0-8-2 

12-11-0-8-3 

12-11-0-8-4 

12-11-0-8-5 

12-11-0-8-5 

12-11-0-8-7 


5-12 
7-11 
7-13 
5-11 
5-13 


backslash 
left brace 
right brace 
left bracket 
right bracket 

left bracket 
right bracket 
lost data 
logical not 


On 2741 terminals, \ is output as (. 
On 2741 terminals, } is output as ). 
On Model 7670, [ is /. On Model 

7015, [is 1. 
On Model 7670, ] is !. On Model 

7015, ] is— i. 
B0 and B6 through BB are unassigned. 

BC, BD, and BF are used by COC for 

output of ANSCII 5-1 1, 5-13, and 

7-14, respectively. 
On 2741 Selectric and EBCD Standard 

Keyboards, [ is output as ( and ] 

is output as ). 


Hexadecimal and decimal notation. 
Decimal notation (column-row). 
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Table H-3. 


CP-V Symbol-Code Correspondences (cont. ) 


EBCDIC* 


Symbol 


Card Code 


ANSCIl** 


Meaning 


Remarks 


Hex. 


Dec. 


CO 


192 


SP 


12-0 


2-0 


blank 


Output only. 


CI 


193 


A 


12-1 


4-1 




C1-C9, D1-D9, E2-E9 comprise the 


C2 


194 


B 


12-2 


4-2 




uppercase alphabet. 


C3 


195 


C 


12-3 


4-3 






C4 


196 


D 


12-4 


4-4 






C5 


197 


E 


12-5 


4-5 






C6 


198 


F 


12-6 


4-6 






C7 


199 


G 


12-7 


4-7 






C8 


200 


H 


12-8 


4-8 






C9 


201 


I 


12-9 


4-9 






CA 


202 




12-0-9-8-2 






CA through CF are unassigned. 


CB 


203 




12-0-9-8-3 








CC 


204 




12-0-9-8-4 








CD 


205 




12-0-9-8-5 








CE 


206 




12-0-9-8-6 








CF 


207 




12-0-9-8-7 








DO 


208 




11-0 






DO is unassigned. 


Dl 


209 


J 


11-1 


4-10 






D2 


210 


K 


11-2 


4-11 






D3 


211 


L 


11-3 


4-12 






D4 


212 


M 


11-4 


4-13 






D5 


213 


N 


11-5 


4-14 






D6 


214 


O 


11-6 


4-15 






D7 


215 


P 


11-7 


5-0 






D8 


216 


Q 


11-8 


5-1 






D9 


217 


R 


11-9 


5-2 






DA 


218 




12-11-9-8-2 






DA through DF are unassigned. 


DB 


219 




12-11-9-8-3 








DC 


220 




12-11-9-8-4 








DD 


221 




12-11-9-8-5 








DE 


222 




12-11-9-8-6 








DF 


223 




12-11-9-8-7 








EO 


224 


_ 


0-8-2 


2-13 


minus 


Output only. El is unassigned. 


El 


225 




11-0-9-1 








E2 


226 


S 


0-2 


5-3 






E3 


227 


T 


0-3 


5-4 






E4 


228 


U 


0-4 


5-5 






E5 


229 


V 


0-5 


5-6 






E6 


230 


W 


0-6 


5-7 






E7 


231 


X 


0-7 


5-8 






E8 


232 


Y 


0-8 


5-9 






E9 


233 


Z 


0-9 


5-10 






EA 


234 




11-0-9-8-2 






EA through EF are unassigned. 


EB 


235 




11-0-9-8-3 








EC 


236 




11-0-9-8-4 








ED 


237 




11-0-9-8-5 








EE 


238 




11-0-9-8-6 








EF 


239 




11-0-9-8-7 








FO 


240 








3-0 






FT 


241 


1 


1 


3-1 






F2 


242 


2 


2 


3-2 






F3 


243 


3 


3 


3-3 






F4 


244 


4 


4 


3-4 






F5 


245 


5 


5 


3-5 






F6 


246 


6 


6 


3-6 






F7 


247 


7 


7 


3-7 






F8 


248 


8 


8 


3-8 






F9 


249 


9 


9 


3-9 






FA 


250 


X 


12-11-0-9-8-2 




multiply 


FA through FF are APL characters 


FB 


251 


■r 


12-11-0-9-8-3 




divide 


for 2741 APL use only. 


FC 


252 


— 


12-11-0-9-8-4 




right arrow 




FD 


253 


— 


12-11-0-9-8-5 




left arrow 




FE 


254 




12-11-0-9-8-6 






FE is not assigned. 


FF 


255 


DEL 


12-11-0-9-8-7 




delete 


Special —neither graphic nor 
control symbol. 


Hexadecimal and decimal 


notation. 








Decimal notation (column- 


-row). 
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Table H-4. 


ANSCII Control -Character Translation Table 




Input 


Output 


ANSCII 


TTY 
Key 


Echoed 


Prog. Receives 
(EBCDIC) 


Process 


EBCDIC 


Transmitted 
(ANSCII) 


NUL (00) 


pes 


None 


None 


None 


NUL (00) 


Nothing (end of 
output message) 


SOH (01)* 


A C 


SOH 


SOH 


None 


SOH (01) 


SOH 


STX (02)* 


B C 


STX 


STX 


None 


STX (02) 


STX 


ETX (03 )* 


c c 


ETX 


ETX 


None 


ETX (03) 


ETX 


EOT (04)* 


D C 


EOT 


EOT 


Input Complete. 


EOT (04) 


EOT 


ENQ (05/ 


E C 


ENQ 


ENQ (09) 


None 


HT (05) 


Space (s) if tab 
simulation on, or 
HT(09) if not. 


ACK (06)* 


F c 


ACK 


ACK 


None 


ACK (06) 


ACK 


BEL (07) 


G c 


BEL 


BEL 


None 


BEL (07) 


BEL 


BS (08) 


H c 


BS 


BS 


None 


BS (08) 


BS 


HT (09) 


I c 


Space to tab stop 
if tabsimuiation 
on, or 1 space if 
not. 


Spaces to tab stop, 
or one space, or tab 
(05) depending on 
space insertion mode. 


None 


ENQ (09) 


ENQ (05) 


LF/NL (0A) 


NL 


CR and LF 


LF (15) 


Input Complete. 


NAK (0A) 


NAK (15) 


VT (OB) 


K c 


VT 


VT 


None 


VT (0B) 


VT 


FF(OC) 


L c 


None 


FF 


Page Header and 
Input Complete. 


FF(0C) 


Page Header 


CR (OD) 


CR 


CR and LF 


CR (0D) 


Input Complete. 


CR (0D) 


CR and LF (0A) 


SO (OE) 


N C 


SO 


SO 


None 


SO (0E) 


SO 


SI (OF) 


o c 


SI 


SI 


None 


SI (OF) 


SI 


DLE (10)* 


P c 


DLE 


DLE 


None 


DLE (10) 


DLE 


DC1 (11) 


Q c 


DC1 


None 


Paper Tape On. 


DC1 (11) 


DC1 


DC2 (12) 


R c 


DC2 


DC2 


None 


DC2 (12) 


DC2 


DC3 (13) 


S c 


DC3 


None 


Paper Tape Off. 


DC3 (13) 


DC3 


DC4 (14)* 


T c 


DC4 


DC4 


None 


DC4 (14) 


DC4 


NAK (15)* 


u c 


NAK 


NAK (0A) 


None 


LF/NL (15) 


CR and LF (0A) 


These charact 
compatibility > 


ers are co 
with future 


nmunication control 
( hardware developm 


characters reserved for 
snts and is done so by i 


use by hardware, 
he user at his own 


Any other use < 
risk 


sf them risks in- 
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Table H-4. ANSCII Control-Character Translation Table (cont.) 



Input 



Output 



ANSCII 



TTY 
Key 



Echoed 



Prog. Receives 
(EBCDIC) 



Process 



EBCDIC 



Transmitted 
(ANSCII) 



SYN (16) 

ETB (17)' 
CAN (18) 

EM (19) 

SUB (1A) 
ESC (IB) 

FS (1C) 
GS (ID) 
RS (IE) 
US (IF) 
f(7D) 

M7E) 

DEL (7F) 



V° 



SYN 



SYN 



None 



SYN (16) 



w v 



Rubout 



ETB 



x c 


Back-arrow 
and CR/LF 


Y° 


Back-arrow 
and CR/LF 


Z c 


SUB 


K CS 
ESC 
PREFIX 


None 


L CS 


FS 


M CS 


GS 


N CS 


RS 


o cs 


US 


ALT- 
MODE 


} or None 


ESC 
(7015) 


~or None 



ETB 
None 

None 

SUB 
None 

FS 

GS 

RS 

US 

| or None 

~or None 

None 



None 

Cancel input 
or output 
message. 

Monitor Escape/ 
Control to TEL 

Input Complete 

Initiate escape 
sequence mode. 



Input Complete 

Input Complete 

Input Complete 

Input Complete 

} if model 37; as 
ESC if model 33, 
35, or 7015. 

~if model 37; as 
ESC if model 33, 
35, or 7015 

Rubout last 
character. 



ETB (17) 
CAN (18) 

EM (19) 

SUB (1A) 
ESC (IB) 

FS (1C) 
GS (ID) 
RS (IE) 
US (IF) 
|(B3) 

i(5F) 
DEL (FF) 



SYN (not trans- 
mitted for last 
character in 
user's buffer). 

ETB 

CAN 

EM 

# (A3) 
ESC 

FS 

GS 

RS 

US 

l(7D) 

~(7E) 

None 



All ANSCII upper and lower case alphabetics are translated on input into the 
corresponding EBCDIC graphics as shown in Tables C-l and C-2. All special 
graphics map as shown, allowing for Table C-l, Note 2, and the exceptions 
above for model 33 and 35. Lower case alphabetics map into corresponding 
EBCDIC upper case if the ESC U mode is set. Upper case alphabetics map 
into corresponding EBCDIC lower case if ESC) is set. 



Alphabetic and symbol output trans- 
lation is also as shown in Tables C-l 
and C-2; for Mode Is 33 and 35, and 
7015 terminals, however, lowercase 
alphabetics are automatically trans- 
lated to upper case. 



These characters are communication control characters reserved for use by hardware. Any other use of them risks in- 
compatibility with future hardware developments and is done so by the user at his own risk. 
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Table H-4. Substitutions for Nonexistent Characters on 2741 Keyboards 



EBCDIC 


A PL 


Selectric 


EBCD 


Character 


Keyboard 


Keyboard 


Keyboard 


> 


> 


, (upper case) 


> 


< 


< 


. (upper case) 


< 


1 


t 
1 


i 
(degree) 


i 
1 


-• 


*%* 


± 


- 


# 


? 


# 


# 


% 


P 


% 


% 


i 


c 


4 


4 


@ 


a 


@ 


@ 


■i 


V 


ii 


H 


i 


o 


! 


! 


& 


n 


& 


& 


$ 


u 


$ 


$ 
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INDEX 



Note: For each entry in this index, the number of the most significant page is listed first. Any pages thereafter are listed in 
numerical sequence. 



* command, ANLZ, 46 

? command, DRSP, 1 10 

I command, ANLZ, 46 

560 cluster/unit matrix, 156 

560 Remote Assist Station, 175,23 

2741 terminal, substitutions for nonexistent characters, 223 



ANSCII, 216,214,221 

AP, 6 

APL, 8 

application processors, 1 1 

armed interrupt, 126 

Assembly Program (see AP) 

automatic recovery, 23 



A Programming Language, 8 
active interrupt, 126 
ALL command, ANLZ, 43 
Analyze (see ANLZ) 
ANLZ, 42,10,23 

batch mode, 42 

command summary, 59,58 
ANLZ, commands, 42 

*, 46 

I, 46 

ALL, 43 

BF, 47 

CLOSE, 48 

COMPARE, 46 

DELTA, 47 

DISPLAY, 43 

DUMP, 48 

END, 49 

HELP, 48 

INPUT, 43 

IS, 48 

LINE FEED, 46 

loc, 43 

!oc=value, 46 

loci, loc2, 46 

LP, 47 

MAP, 46 

MONITOR, 46 

NODELTA, 47 

PRINT, 47 

ROWS, 47 

RUN, 43 

SEARCH, 47 

SMASK, 47 

SPY, 48 

SYMBOLS, 48 

SYMBOL/, 48 

UC, 47 

UNMAP, 46 
ANLZ, ghost mode, 42 
ANLZ, messages, 58 
ANLZ, on-line mode, 42 
ANLZ, output, 49 
ANS COBOL (see COBOL) 
ANS labeled tape, xi 



B 



BASIC, 6 

Batch (processor), 1 1 

batch job, x? 

batch processing, 1 

BF command, ANLZ, 47 

binary input, xi 

booting, 24,37 

from disk, 40 
bootstrap I/O error recovery, 40 
bootstrap operations (see booting) 



CCI, 99,4 

character sets, 214 

CIRC, 12 

cleared interrupt, 126 

CLIS command, ELLA, 68 

CLOSE command, ANLZ, 48 

cluster/unit matrix, 156 

COBOL, 7 

COBOL On-Line Debugger, 10 

codes and correspondences, 214 

command processor programming, 101 

command processors, 3 

command summaries, ANLZ, 59,58 

DRSP, 113,110 

ELLA, 91,90 

reconfiguration and partitioning, 29,24 
command syntax notation, x 
commands, control, x? 
COMPARE command, ANLZ, 46 
compressed language, 213 
concatenation, xi 

conditional patch control commands, 35 
conflicting reference, xi 
Control (processor), 4 
control codes, 214 
Control Command Interpreter, 94,4 
control commands, xi 
control message, xi 
cooperative, xi 
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CP-V operating system, 3 
crash analysis (see ANLZ) 



Data Control Block, 96, xi 
DCB, 96, xi 

diagnostic, 122,115,120 
DDCB, 122,115,120 
DEFCOM, 10 
DELETE command, DRSP, 109 

GENMD, 34 
Delta, 9 

DELTA command, ANLZ, 47 
Delta format patches, 24 
DEV command, ELLA, 84 
DEVDMP, 5 

device designation codes, 156 
device names, 156 
Device Save/Restore processor, 5 
device type codes, 156 
diagnostic DCB, 122, 1 15 

diagnostics (see on-line peripheral diagnostic facilities) 
disabled interrupt, 126 
disarmed interrupt, 126 
DISP command, ELLA, 81 
DISPL command, ELLA, 87 
DISPLAY command, 

ANLZ, 43 

PPS, 145 
DRSP, 106,11 

DRSP, command summary, 1 13, 1 10 
DRSP, commands, 

?, 110 

DELETE, 109 

END, 110 

ENTER, 106 

LIST, 109 

LISTALL, 109 

REPLACE, 109 
DRSP, error messages, 11 1, 1 10 
DRSP, limitations and restrictions, 110 
DUMP command, ANLZ, 48 

Dynamic Replacement of Shared Processors (see DRSP) 
DYNRESDF command, PPS, 146 



EASY, 4 

EBCDIC, 215,214 

Edit (processor), 10 

EDMS, 11 

ELLA, 65,11,22 

ELLA, command summary, 91,90 

ELLA, commands, 

CLIS, 68 

DEV, 84 



DISP, 81 

DSPL, 87 

END, 82 

MOD, 84 

RSET, 82 

SET, 65 

SLIS, 77 

SUM, 81 

TIME, 83 

TYPE, 84 
ELLA, 

error log entry headings, 70 

error log entry types, 77 

input/output assignments, 65 

input/output characteristics, 67 

interrupting execution, 68 

messages, 90 

predefined tasks, 87 

RBrFLAGS structure, 75 

starting execution, 65 
enabled interrupt, 126 
END command, ANLZ, 49 

DRSP, 110 

ELLA, 82 

PPS, 147 
:END command (boot-time), 29 
ENTER command, DRSP, 106 
ERR-.FIL, 65,22 
ERRFILEfile, 178,65 
ERRFILE file formats, 178 

bad granule release, 188 

configuration record, 187 

device error, 184 

duplicate entries, 187 

enqueue table overflow, 196 

errlog record length error, 182 

file inconsistency error, 186 

hardware errors, 192 

I/O activity count, 192 

illegal entry type, 183 

incorrect time, 183 

instruction exception, 194 

lost entry indicator, 187 

memory fault interrupt, 183 

memory parity secondary record, 195 

MFI primary record, 194 

operator message, 192 

partitioned resource, 196 

PFI primary record, 194 

power on, 187 

processor fault interrupt, 183 

read error, 182 

remote processing error, 188 

returned resource, 196 

secondary records for disk pack, RAD, and tape, 185 

Sigma 6/7 memory parity secondary record, 195 

SIO failure, 183 

software-detected symbiont inconsistencies, 186 

system identification, 187 

system startup, 185 
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time out, 184 

time stamp, 188 

unexpected interrupt, 184 

watchdog timer, 193 

Xerox 560 memory parity secondary record, 195 

Xerox 560 secondary record for poll information, 195 
ERRMSG file, 63 

error detection and recovery, 22, 23 
error log file (see ERRFILE) 
Error Log Listing program (see ELLA) 
error log, 

reading, 92 

writing, 92 
error message file, 63 
error messages (see messages) 
error record terminology, 178 
execution control processors, 9 
Extended Data Management System, 1 1 
Extended FORTRAN IV, 5 
external reference, xi 



GET command, PPS, 145 

ghost job, xi 

ghost job, initiating, 92 

global symbol, xi 

:GO command (boot-time), 27 

GO file, xi 

GPDS, 12 

Granule Accounting Cleanup processor, 5 

granule, x? 



H 



hardware-error diagnostic CALs, 91 

initiate ghost job, 92 

read error log, 92 

write error log, 92 
HELP command, ANLZ, 48 



FDP, 9 

file maintenance processors, 23 

files, 

extension, 101,xi 

identification, 98 

shared, 101 
FILL (processor), 4 
Fix (processor), 4 
fixed monitor locations, 44 
FLAG, 7 
FORTRAN, 5 

FORTRAN Debug Package, 9 
FORTRAN libraries, 98, 14 
FORTRAN Load and Go, 7 
FPT, xi 

FREE command, PPS, 145 
FRES, 5 
FSAVE, 5 
function parameter table, xi 



I 



I/O scheduling, 18 

ICB, 126 

initialization and start-up routines, 24 

INPUT command, ANLZ, 43 

interrupt connection and control services, real-time, 126 

interrupt control block, 126 

interrupt label, 126 

IOP designation codes, 156 

IS command, ANLZ, 48 



JIT, 95, xi 
job step, xi 



GAC, 5 

:GENDCB command, 34 
General Purpose Discrete Simulator, 12 
GENMD, 
commands, 
DELETE, 34 
GENMD, 34 
LIST, 34 
error messages, 36, 35 
patches, 35 
GENMD command, GENMD, 34 



key, xi 
key-in, xi 



Label, 5 

language processors, 5,xi 

libraries, 104 

FORTRAN, 98, 14 

public, 104, xii 

system, xiii 
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library load module, xi 

LINE FEED command, ANLZ, 46 

Link (processor), 9 

linking loader, xi 

LIST command, 

DRSP, 109 

GENMD, 34 
list formats (transaction processing), 152 
LISTALL command, DRSP, 109 
Load (processor), 9 
load map, xi 
load module, xi 
loc command, ANLZ, 43 
loc = value command, ANLZ, 46 
locl,loc2 command, ANLZ, 46 
log-on connection, 94 
logical device, xi 
logical device stream, xi 
LOGON/LOGOFF, 3 
LP command, ANLZ, 47 
LYNX (processor), 9 



MrSTARTIO, 134 
MrSTOPIO, 132 
Manage, 12 

MAP command, ANLZ, 46 
master system tape, 24, 25 
memory control, 96 
memory layout, 20 
memory management, 14 
messages, 

ANLZ, 58 

DRSP, 111,110 

ELLA, 90 

GENMD, 36,35 

on-line peripheral diagnostics, 114 

PASS0, 41 

reconfiguration and partitioning, 32,31 
Meta-Symbol, 6 
MOD command, ELLA, 84 
monitor, 13,xii 

MONITOR command, ANLZ, 46 
monitor DEFs (for real-time), 147 
monitor dump analysis program (see ANLZ) 



M 

MrBLIST, 117 
MrCHKINT, 139 
M:CLOCK, 132 
MrCOC, 143 
MrCONNECT, 127 
M:DCLOSE, 117 
MrDDCB, 115 
M:DISCONNECT, 128 
M:DMOD#, 120 
MrDOPEN, 116 
M:EXCP, 140 
M:EXU, 136 
M:FPP, 137 
MrGDG, 138 
M:GETID, 149 
MrGJOB, 137 
M:GJOBCON, 127 
M:GPP, 137 
M:HOLD, 131 
MrlNHIBIT, 129 
M:INTCON, 129 
MrlNTRTN, 130 
MrlNTSTAT, 131 
MrlOEX, 134 
MrLOCK, 119 
M:MAP, 120,137 
M:MASTER, 136 
MrNEWQ, 140 
M:QFI, 130 
MrQUE, 142 
M:QUEUE, 149 
M:RDG, 138 
M-.RUE, 138 
M:SIO, 119 



N 

NODELTA command, ANLZ, 47 



object language, 195, xii 

object module, xii 

on-line job, xii 

on-line peripheral diagnostic facilities, 114,22 

abnormal codes and messages, 121, 120 

DDCB, 122,115,120 

MrBLIST, 117 

M:DCLOSE, 117 

MrDDCB, 115 

MrDMOD#, 120 

MrDOPEN, 116 

MrLOCK, 119 

MrMAP, 120,137 

MrSIO, 119 

PSECT directive, 114 

restrictions, 1 14 
operational label, 155, xii 
output (see messages) 
overlay loader, xii 
overlay program, xii 
overlay restrictions, shared processors, 96 



page allocation for real-time, 143 
rPART command, boot-time, 29 
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partitioning resources, 27,29 

PASSO, 41 

PASSO, error messages, 41 

patch, xii 

patch control commands, conditional, 35 

patch deck comment cards, 37 

patch deck structure, 24 

patch deck symbol table, 26 

patch file creation, 37 

patches, Delta format, 24 

patching operations, 24 

PCL, 10 

Peripheral Conversion Language, 10 

peripheral device (see device) 

peripheral diagnostic facilities (see on-line peripheral 

diagnostic facilities) 
physical device, xii 

physical page allocation for real-time, 143 
Physical Page Stealer (see PPS) 
PPS, 144 
PPS, commands, 

DISPLAY, 145 

DYNRESDF, 146 

END, 147 

FREE, 145 

GET, 145 

RESDF, 146 
preventive maintenance, 65 
PRINT command, ANLZ, 47 
procedures, 

M-.BLIST, 117 

MrCHKINT, 139 

MrCLOCK, 132 

M:COC, 143 

MrCONNECT, 127 

M:DCLOSE, 117 

MrDDCB, 115 

MrDISCONNECT, 128 

M:DMOD#, 120 

MrDOPEN, 116 

M:EXCP, 140 

M:EXU, 136 

M:FPP, 137 

M:GDG, 138 

M-.GETID, 149 

M:GJOB, 137 

M:GJOBCON, 127 

M-.GPP, 137 

M:HOLD, 131 

M:INHIBIT, 129 

M:lNTCON, 129 

MrlNTRTN, 130 

MrlNTSTAT, 131 

M:IOEX, 134 

M:LOCK, 119 

M:MAP, 120,137 

MrMASTER, 136 

M:NEWQ, 140 

M:QFI, 130 

M:QUE, 142 



MtQUEUE, 149 

M:RDG, 138 

M:RUE, 138 

M:SIO, 119 

MrSLAVE, 136 

M:STARTIO, 134 

M:STOPIO, 132 

real-time, 126 
processor management, 19 
processor privileges, 93 
processors, 

application, 11 

command, 3 

execution control, 9 

language, 5,xi 

service, 10 

shared processor facilities, 106 

system management, 4 

user, 13 
program product, xii 
prompt character, xii 
protective mode, xii 
PSECT directive, 114,137 
public library, 104,xii 
public programs, 93 



RATES, 4 
RBrFLAG, 189 
read error log, 92 
real-time facilities, 126,2 

clock service, 132 

device preemption services, 132 

direct I/O services, 134 

dynamic physical page allocation, 143 

interrupt connection and control services, 126 

lock in core service, 131 

miscellaneous services, 137 
real-time libraries, 106, 104 
reconfiguration and partitioning commands, 27 

:END, 29 

:GO, 27 

:PART, 29 

: REMOVE, 28 

:SAVE, 28 

:TYPE, 28 
reconfiguration and partitioning commands summary, 27,24 
reconfiguration and partitioning messages, 32,31 
recovery, 22,23 
reentrant, xii 
relative allocation, xii 
relocatable object module (ROM), xii 
Remote Assist Station, 175,22 
remote diagnostic assistance, 175,22 
remote processing, 2,xiii 
:REMOVE command (boot-time), 28 
REPLACE command, DRSP, 109 
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Report Program Generator/ 8 

RESDF command, PPS, 146 

RESDF memory CAL, 147 

resident program, xii 

response time, xii 

ROM, xii 

ROWS command, ANLZ, 47 

RPG, 8 

RSET command, ELLA, 82 

RUN command, ANLZ, 43 



:SAVE command (boot-time), 28 

scheduler, xii 

scheduler inputs, 15 

scheduler operation, 16 

scheduler output, 16 

scheduler status queues, 17 

scheduling, 14 

screech codes (see software check codes) 

SEARCH command, ANLZ, 47 

secondary storage, xii 

semi-protective mode, xii 

service processors, 10 

SET command, ELLA, 65 

shared file use, 101 

shared processor, xii 

shared processor facilities, 93 

shared processor maintenance, 106 

shared processor programming, 94 

shared programs, 93 

Show processor, 11 

Simulation Language, 8 

SL-1, 8 

SLIS command, ELLA, 77 

SMASK command, ANLZ, 47 

software check codes, 157 

Sort/Merge, 1 1 

source language, xii 

special shared processor, xii 

specific allocation, xii 

SPY command, ANLZ, 48 

standard object language, 197 

start-up, 24 

static core module, xiii 

STATS, 5 

status queues, 17 

stream-id, xiii 

SUM command, ELLA, 81 

Summary (processor), 5 

Super (processor), 4 

swap hardware organization, 18 

swap-in, swap-out queues, 18 

symbiont, xiii 

Symbol Control Processor, 10 

symbol-code correspondences, 214 

symbolic input, xiii 



symbolic name, xiii 

SYMBOLS command, ANLZ, 48 

SYMBOL/command, ANLZ, 48 

symbols, graphic, 214 

SYMCON, 10 

SYSCON, 5 

SYSGEN, 10, xiii 

SYSTEM DIAG, 115 

system error log file (see ERRFILE) 

system generation, 10, xiii 

system integrity, 20 

system library, xiii 

system loading, 24 

system management processors, 4 

system programming facilities, 2 

System Queue Manager, 148 

system register, xiii 

SYSTEM RTPROCS, 126 

SYSTEM SIG7, 115 

SYSTEM SIG9, 115 

system start-up and initialization, 24 

system tape format, 24,25 



tape, master system, 24, 25 

task control block (TCB), xiii 

TEL, 4 

TEL scan, 98 

Terminal Executive Language, 4 

terminal I/O, 99 

TIME command, ELLA, 83 

time-sharing, 1 

transaction processing, 2 

transaction processing facilities, 148 
list formats, 152 
M:GETID, 149 
MrQUEUE FPTs, 150 
M:QUEUE procedure format, 149 
MrQUEUE procedure output, 153 
System Queue Manager, 148 

TYPE command, ELLA, 84 

:TYPE command (boot-time), 28 



u 

UC command, ANLZ, 47 
UNMAP command, ANLZ, 46 
unsatisfied reference, xiii 
user processors, 13 
user status queues, 17 
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virtual memory, special processors, 44 
VOLINIT, 5 

w 

waiting interrupt, 126 
write error log, 92 



Xerox 560 cluster/unit matrix, 156 
Xerox 560 Remote Assist Station, 175,23 
Xerox standard compressed language, 213 
Xerox standard object language, 195 
Xerox standard symbols, codes, and 
correspondences, 214 
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